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PREFACE 


The MUMPS-11 Language Manual is a reference manual designed to provide 
the MUMPS-11 programmer with complete and easily accessible 
information about all aspects of the MUMPS-ll Language. New users 
should refer to the Introduction to MUMPS-11l Language tutorial manual. 


Chapter 1 describes the elements of the language including: the 
character set, programming modes, program structure, data modes, 
numbers, strings, literals, constants and variables. 


Chapter 2 describes how to form expressions in MUMPS-ll and how they 
are evaluated. 


Chapter 3 describes each MUMPS-11 Command including: its syntax, 
arguments, meaning and examples of use. This chapter is arranged for 
quick reference; each command begins on a new page with the command 
name in large bold type in the upper corner. Chapter 4 describes each 


MUMPS-11 Function including: its syntax, arguments, meaning and 
examples of usSe. This chapter is presented in the same format as 
Chapter 3. 


Appendices provided include: Glossary of Terms, Character Set, Error 
Messages, Symbol Usage and Conversion Tables. 


Associated Documents include: 


Getting Started With MUMPS-11 
DEC-11-MMGSA-A-D 


Introduction to MUMPS-1l Language - Tutorial Manual 
DEC-11-MMLTA-C~-D 


MUMPS-11 Programmer's Reference Card 
DEC-11-MMPCA-C-C 


MUMPS-1ll Programmer's Guide 
DEC-1L1-MMPGA-D-D 


MUMPS-11l Operator's Guide 
DEC-11-~MMOPA-D-D 
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FOREWORD 


MUMPS-11 is an interactive single language, multi-user time-sharing 
system that allows access to a common data base. The capabilities of 
the system are heavily oriented towards string manipulation using a 
high level language. The system relieves the user of any concern for 
programming peripheral devices or for structuring data bases in the 
traditional sense. 


Language processing by the system iS in every sense interpretive. 
Each line of code undergoes identical processing each time it is 
executed (intermediate code is not generated). The MUMPS application 
programmer is relieved of all the burdens associated with driving 
peripheral equipment or the programming of assembly language. He may 
concentrate his energies to the analysis aspects of his problem. His 
major problems are concerned with developing proper loqical hierarchy 
for his data base, and developing efficient logic for his data 
processing requirement. | 


The MUMPS language is supported by a stand-alone operating system. In 
addition to implementing the MUMPS language and providing all 
operating system capabilities, the system affords the user a unique 
data base structure and access method. Data which is referred to 
symbolically is automatically stored and linked in a tree structure. 
The physical allocation of mass storage for the tree structured data 
base is accomplished by the operating system. The data base thus 
created iS available to other users in the system. 
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Symbol 


bve 


gvar 


lvar 


nve 


pnam 


spn 


sve 
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Definition 


A Boolean valued expression iS an expresSion which is 
interpreted as either TRUE or FALSE depending on 
whether its result iS a non-zero or zero value 
respectively. The standard value for TRUE created by 
MUMPS is -.0Ol. 


A global variable iS a variable which is an element of 
a global. 


A local variable is a variable which is temporary and 
resides in the user's partition. 


A numeric valued expression iS an expression. which, 
when evaluated, yields a numeric result within the 
range of valid MUMPS-11 numbers. 

A program name consists of any legal identifier, the 
first character of which may be a %& to irdicate a 
library program name. 

Any valid Step or Part number. 

A string valued expression iS an expression which 
results in a string of ASCII characters which does not 
exceed maximum string length of 132 characters. 


A string variable or literal (a more specific case of 
Sve). 


Universal symbol for line terminator. Line terminators 
for terminals are either Carriage Return or ALTMODE. 


A single space. 
Fields described within braces are optional. 


Vertical bars are used to contain a list of options 
among which a single choice must be made. 


(Continued on next page) 
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UPPER CASE/ 
lower case 
characters 


pene 


UNDERLINING 


Definition 


Upper - case characters ineieave elements of the language 
which must be used exactly as shown. Lower case 
characters indicate user supplied elements (sve, nve, 
etc.) — or letters: in a command name which may be 
omitted, = | 


The . punctuation éhareceere peee are used to. indicate 
optional continuation of a command argument list in the 


form of the last specified argument. 


All examples showing keyboard (i.e., Direct Mode) input” 


are underlined. 
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CHAPTER 1 


ELEMENTS OF THE LANGUAGE 


A MUMPS-11 program is a sequence of symbolic statements which the 
MUMPS Language Interpreter translates for execution by the operating 
system. 


A command is the basic unit of expression in the MUMPS' Language. 
Commands have one or more elements. The first is a mnemonic which 
characterizes or symbolizes the action to be performed. Examples: 
GOTO, SET. The other elements in a command are called arguments, and 
they specify the objects of the action to be performed. 


There are six functional categories of MUMPS commands. 


Category General Function 
Assignment Commands Assign values to symbolic representations. 
Control Commands Govern the sequence in which commands are 


executed. 


Input/Output Commands Direct the input and output of data to. and 
| from the various devices in the hardware 
environment. 


Editing Commands Permit the examination, modification, and 
storing of programs. 


Debugging Command Facilitate the creation and maintenance of 
MUMPS programs. ) 


Timesharing Commands Permits database timesharing protection. 


The format and syntax of MUMPS commands are described in detail in 
Chapter 3. 


1.1 CHARACTER SET 


All MUMPS-11 programs are constructed of symbolic characters which 
form the elements of the language. MUMPS programs use the 
64-character graphic subset of ASCII, along with the special control 
characters listed in Table 1-1. Characters that are used as data may 
be selected from the entire 128-character ASCII set. Ordinarily, 
however, those listed in Table 1-1 will appear in language elements 
Only. Appendix B lists the ASCII character set. 
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Table 1-1 
Special MUMPS Control Characters 


NUL Line Terminator (internal) 

Carriage RETURN Line Terminator (external) 

ALTMODE Line Terminator (external) 

Line Feed Line Terminator (external) 

Form Feed © | Line Terminator (external) 

Vertical Tab Line Terminator (external) 

DEL (Rubout) Delete Character (prior to typing 
terminator) | 

CTRL U Delete Line (prior to typing terminator) 

CTRL O Suppress output to terminal 

CTRL C Sign-on signal by nteeeape suneent 

BREAK Key operation 


1.2 PROGRAMMING MODES 


There are two operating modes available to the programmer: Indirect 
Mode and Direct Mode. Indirect Mode is the mode in which MUMPS 
executes a stored program. Most MUMPS commands may also be 
interpreted outside the context of a stored program. In Direct Mode, 
Such commands are executed immediately after entry from a terminal, 
much like the operation of a desk calculator. Direct Mode is used 
when creating, modifying, or storing MUMPS programs. 


1.3 PROGRAM STRUCTURE 


A MUMPS program consists of one or more uniguely numbered lines of 
commands and arguments, and comments. These lines, called Steps, are 
terminated by either Carriage RETURN, ALTMODE, or ESCape (symbolized 
in this manual by a ./). Each program Step is stored in the user's 
memory partition for subsequent execution in Indirect Mode. The 
general format for a step is: 


Step Number} {commandwsarguments} 4... {;comment } +/ 


A line of commands not having a Step Number is called a command line 
and is executed in Direct Mode immediately after it is entered from a 
terminal. Neither a Step nor a command line may contain more than 132 
characters. Specific rules for command syntax are provided in Chapter 
ce | 
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1.3.1 Step Numbers 


A Step Number is used to identify each line of a MUMPS program. Step 
Numbers establish the fundamental sequence of program execution. 
Within a given Part (Section 1.3.2), each line of a program is 
executed sequentially in ascending Step Number order (assuming, of 
course, that no Control Commands (Section 3.3) were encountered). 


A Step Number iS a poSitive number in the range 0.01 through 327.67. 
The fractional part of a step number must be non-zero (e.g., 1.00, 
198.00, etc., are illegal). Unless explicitly stated in the 
appropriate command argument, user program execution begins with the 
Step having the lowest non-zero integer. Step numbers in the range 
0.01 through 0.99, though normally used to contain program comments, 
can contain executable commands; however, control must be explicitly 
transferred to these steps via arguments to the commands: GOTO, DO, 
CALL, OVERLAY, and START. 


Examples of valid Step Numbers are: 


1.3.2 Part Numbers 


All Steps having a common integer base form a Part. Parts are used to 
form program modules, each module specifying a particular procedure 
within a program. A program may have one Part or many Parts, as_ the 
programmer desires. Each Part is a distinct entity with regard to 
program execution. Execution control is limited to those steps within 
a Part, and Control Commands such as GOTO, DO, OVERLAY, etc., must be 
used to effect transfer of control outside of a Part. All Steps in a 
Part may be collectively referenced by the Part Number alone. 


For example: 
The series of Steps: 


2.01 
2.04 
2.10 
Zah 
2.99 


can be referred to as Part 2. The command GOTOuu2 .would cause all 
Steps in Part 2 to be executed. 


1.4 DATA MODES 


MUMPS-11 interprets all data in one of two ways: either as numeric 
Quantities, such as might be used for calculation, or as strings which 
Simply impart their inherent symbolic meaning, such as names- and 
addresses. | | 7 
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1.4.1 Numbers 


Numbers in MUMPS are signed, fixed-point, two-place decimal quantities 
in the range £21474836.47 [or -(2°'-1)/100<n<(2*! -1)/100]. a 


On input from a terminal or other device, numeric strings used 
arithmetically which are outside the specified range, are flagged with 
the following error messages: 


MXNUM Integer portion too large | 
MINIM Fractional portion more than 2 places 


Numbers that are stored internally as intermediate results during 
processing must also conform to the specification, except that decimal 
fractions are truncated to two places. (No error is created within 
the system.) | 


On output, a sign is printed only for negative quantities. Integer 
quantities are printed without decimal point and trailing zeroes in 
the fractional part. Decimal fractions are printed with a single 
leading zero in the form: O.nn. 


Examples of legal numbers are: 


1.4.2 Strings. 


A string is any contiguous sequence of legal MUMPS characters which is 
to be considered a single identifiable entity of data. Examples of 
Strings are: 


HELLO. MY NAME IS: 

55 seconds 

2,000,345,876,743.4738501 

When in the course of human events... 
Q@S$#3¢764908!1PoutSFCerhcmAdAtwhS _ 


1.5 IDENTIFIERS 


An identifier is a string consisting of one to three alphanumeric 
characters. Identifiers are formed from the characters 0 - 9, the 
upper case alphabetics A through Z, and the percent (%) character. 
The first character must be either an alphabetic character or the &% 
Character. Remaining characters may be either alphabetic or numeric 
characters (the % character is legal in the first character position 
only). Identifiers are used as symbolic names for variables. and 
programs as described later. Identifiers for System Library Programs | 
and Library Globals, however, must use % exclusively as the first 
character. | : 
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Examples of identifiers are: 


TST SBE M 
A4R S11 SX 
Z2Z0 


1.6 EXPRESSING DATA VALUES 


Program data values may be expressed in several ways in a MUMPS 
program. The basic units - string literals, numeric constants, and 
variables - represent single entities of data having either string or 
numeric values. Literals and constants cannot be altered during a 
program's execution; variables have whatever values are currently 
asSigned to them. New values may be computed from known values of 
these data elements uSing MUMPS commands, functions, and operators 
which are described in succeeding chapters. 


1.6.1 Literals 


A literal is used to specify a string of characters which does not 
change from one execution of eae program to the next. A literal may 
comprise any valid string of characters enclosed in quotation marks 
(""). A literal may not contain any of the following characters: 


Quotation Mark CTRL C Line Feed 
Carriage RETURN DEL (Rubout) Form Feed 
ALTMODE NUL Verticl Tab 
CTRL U CTRL O 


Examples of literals are: 


"1234.1098+=" 
"THE ANSWER IS:" 
"G$536svfjri'sPPkl;" 


1.6.2 Constants 


A constant is used to express a numeric quantity which does not change 
from one execution of a program to the next. A constant may consist 
of any valid MUMPS number (+21474836.47). 


Example of constants are: 


234.90 

. 08 
00578.99 
3) 469 


T1363 Variables 


A variable is a symbolic representation of a logical storage location. 
Unlike literals and constants, variables are used to store data which 
may be altered during a program's operation. Variables may contain 
either numeric or string data. Numeric data must be within the legal 
range for MUMPS numbers +21474836.47. String data must conform to the 
requirements for MUMPS character strings. Variables must be assigned 
symbolic names which are legitimate identifiers (see Section 1.5). 


L=5 
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Three types of variables can be created in MUMPS: Simple Variables, 
Subscripted Variables, and Global Variables. Variables are created, 
modified, and deleted using the SET, READ, REEBs and XKILL commands 
described in Chapter 3. 


Examples of variables are: 


A 
X37 
SDF 
M4zZ 
3X 


System Variables are a fourth type of variable in the MUMPS system. 
These variables, maintained by the operating system, contain general 
system information for use by all MUMPS programs. System variables 
are "read. only"! variables and cannot be altered as can normal 
variables. These variables use a dollar sign ($) as the first 
character of their. names. 


1.6.4 Subscripts and Arrays. 


A subscript iS a numeric valued expression (nve) enclosed in 
parentheses that is appended to a variable name to uniquely identify a 
data element residing under that variable name. All the subscripted 
variables residing under a common name are collectively referred to as 
an array. An array may consist of either subscripted local variables 
Or subscripted global variables (Sections 1.6.6.2 and 1.6.7.1). 


The following is an example of an array with a single level of. 
subscripting: | 


DOG (0.1) 
DOG (3.5) 
DOG (34.76) 


DOG (nnnn.nn) 


An example of a global array with multiple subscripting levels is: 


tACT (1,1) 
4ACT (1,1,1) 
4ACT (1,2). . 
TACT “(lo 2 9d.) 
tACT (1,2,2) 


sACT (1,3) 
The value of a subscript must be a positive number in the range: 0 


through 20,971.51.’ Subscripts may consist of constants, other 


= Exception: SError is "read/write". 


2. The SHIGH function (Section 4.2.6) permits an exception to this 
rule. | a — | 
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variables (which may be subscripted), and expressions (described in 
Chapter 2). In addition, string variables and literals (svl) may also 
be used for subscripting. However, the SCREATE function (described in 
Chapter 4) must be used to convert the string to a unique number. 


1.6.5 Sparse Arrays 


A sparse array iS an array in which only those elements that are 
explicitly defined or that are required to support the array structure 
actually exist. Unlike other languages tnat may require a declaration 
of the maximum size of an array to preallocate storage space, MUMPS 
dynamically allocates storage for all arrays only as needed, thus 
conserving storage space. If a program defines an array which has the 
following elements, 


A (4) 
A (102) 
A (345) 


only these three elements actually occupy storage space. A program is 
penalized for occupying too much space when, indeed, there is no space 
left. 


A local array can only have one level of subscripting. 


1.6.6 Local Variables 


Local variables are variables which reside in the same partition as 
the commands or Steps which created them. These variables are 
accessible only to that partition. Local variables are normally used 
to contain intermediate or transient data which is not to be saved 
from one execution of a program to the next. There are two types of 
local variables: simple and subscripted. 


1.6.6.1 Simple Variables - A simple variable is a local variable 
which is not subscripted. Examples of simple variables are: 


ABC 
HAT 
R45 
X 
6D 


1.6.6.2 Subscripted Variables - A subscripted variable is a local 
variable which is followed by one subscript and can be used to form a 
one-dimensional array. Both subscripted variables and local variables 
may share a common name. Thus, it is possible for both the array ABC 
as well as the simple variable ABC to exist simultaneously. The 
programmer should exercise caution when naming variables in this way, 
Since the KILL Command does not distinguish between the two types when 
no subscript is specified (see Section 3.4.14). 


Examples: 


AGE (AGE) AGE (ABC (DEF) ) 
AGE (2.45) ABC (2876) 
AGE (A+3.2/T) ABC (4+B(C*F)/0.89) 


1-7 
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1.6.7 Global Variables 


1.6.7.1 Structure - MUMPS uses one or more disk devices as the 
primary data storage medium. Access to this storage is gained through 
the use of global variables (or global nodes). Like local variables, 
they are created simply by reference in a program or command line. 
Global variables can be either simple or subscripted. When they are 
Subscripted, the resulting arraysS are sparse arrays. Unlike local 
variables, global variables provide permanent storage and can be 
accessed by more than one user.' Furthermore, there is no limit to 
the number of levels of subscripting that can be used in forming 
global arrays permitting the creation of hierarchical data structures 
that schematically look like inverted trees. Global variables may 
possess either a string or a numeric data value. In addition, when 
used in an array, they may also serve as pointers to variables at a 
lower level in the tree structure. 


The naming conventions for global variables are the same as for local 
variables, except that a circumflex (*) or up-arrow (t+) must precede 
the name. Multiple subscripts are separated from ‘each. other by a 
comma. The following example should clarify this discussion. | 


In the array tABC, assume the following elements are defined: 


Variable Contents 
tABC 

4ABC (1) "ABC" 
tABC (1,2,1) "AGE" 
tABC (1,2,2) "NAME" 
tABC (2) "VALUES" 
tABC (2,4). 364.9 
tTABC (2,4.50) 832.01 
tABC (3,87) 777" 


A diagram of this array would look like this: 


1. As described in MUMPS-11 Programmer's Guide. 
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— oe ae Cee eC eee ae eeeees=sSss ieee a see i eee eee 
eee 


FIRST LEVEL OF 
SUBSCRIPTING 


SECOND LEVEL OF } 
SUBSCRIPTING (1,2) ek a) (2,4.50) (3,87) 
Ne 504.9 832.01 "ZZz" 


— mr er re ee 
eee eee ee eee a i ore —_— 


THIRD LEVEL OF 
SUBSCRIPTING (1, 2,1) (1,2,2) 
"AGE" "NAME" 


mm nas 


(TOTAL NUMBER OF BLOCKS=5, EXCLUDING THE DIRECTORY BLOCK ) 


Note that there are some global nodes which exist solely to point to a 
node which contains data. Such is the case with tABC, tABC (3) and 
ABC (1,2). These nodes are defined implicitly. Other variables such 
as +tABC (1) and tABC (2) contain both data and a pointer to data at a 
lower level. Still other variables, those at the lowest level of a 
branch in the tree, may contain only data. Such is the case with tABC 
(1,2,1), fABC (1,2,2), tABC (2,4), etc. 


A secondary feature of globals is that the top or highest node of a 
global, in addition to storing the global name and pointers to lower 
levels, can be used to store auxiliary numeric or string data, like 
any other variable. Thus: 


SETwwtABC="THIS GLOBAL CONTAINS SALARY DATA" 


1.6.7.2 Naked Reference - The naked reference is a facility within 
the language that permits the programmer’ to avoid excessive disk 
accesses during program operation. Each time a regular gqlobal 
variable reference is made (e.g., SET,,A=tABC (1,2,1)), a physical 
disk access is performed to bring the disk block containing that 
global variable into memory. Since global variables at the same level 
of subscripting reside in the same or a related disk block, a physical 
access iS not always necessary when accessing globals at the same 
level. Using the naked reference, disk accesses are made only when 
the subscripting level is changed, or when a "continuation block" at 
the same level must be read-in to locate the desired variable. 


In form, only the up-arrow and subscripts are explicitly stated; the 
global name is assumed from the last global reference made. The first 
stated subscript in the naked reference replaces the last subscript 
stated in the previous” reference. The first stated subscript is 
assumed to be at the same level as that of the previous one. Thus, in 
the last example, if a reference to #ABC (2) has been made and tABC 
(1) is to be accessed next, only the subscript need be specified as 
in: 
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Similarly, if tABC (1,1,2) is to be accessed next, then: 


is all that is required. In this case, however, a disk access is 
required since the subscripting level has changed. 


By far the most common errors that occur in the use of global arrays 
stem from the incorrect use of the naked reference. The following 
examples illustrate some of the problems that may be encountered. 
These examples represent only a few of the many possibilities for 
producing erroneous results when using the naked reference. It is a 
powerful tool, but one that must be used cautiously. 


Example 


> IF $DC+ACI,J))=8 SET tC J) =VAL 


In this case, the user is testing the status of tA (I,J) by means of 
the SDEFINE function. If SDEFINE returns a zero value, that node is 
undefined. The user then reasons that since SDEFINE has brought him 
to the desired level, he is safe in using the naked variable. 
Incorrect!! The user has no way of knowing where the search has ended 
and thus cannot know the current level. For example, the search may 
have ended at the first level if no +A (I) node was’ defined. To be 
safe, the user should use the full reference as in: 


>IF $D(TACI,d)) =VAL 


Of course, if $DEFINE returns a non-zero result, the use of naked 
variables is perfectly safe. | 


Example 
2.61 SET +G(1.J.K)=1(K) 41 


This command string is legal, but the result will not be what the user 
desires if his intent is to increment the global specified to the left 
of the equal sign. The problem lies in the order of evaluation that 
MUMPS uses for processing a SET command string. The first side of the 
equal sign (=) to be evaluated is the right side. The naked reference 
in this case will access the level last reached, which is not 
necessarily the same as #G (I,J,K) on the left side of the equal sign. 


The correct form is: 
2.01 SET 1(K)=1G(I,d,K)+1 


Further information on the structure and use of globals is provided in 
Introduction to MUMPS-11 Language and MUMPS-11l Programmer's Guide. 


1.6.8 System Variables 


A number of special "reference only" variables are defined within the 
system to control the flow of information and to provide system 
information to MUMPS application programmers and_ users. These 
variables, called System Variables, are maintained and updated by the 
system. They can be examined by various MUMPS commands (TYPE, SET, 
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etc.) but, except for SError, they cannot be directly altered by SET 
or READ commands. When referencing System Variables in MUMPS programs 
only the dollar sign and the first character after it need be used 
(e.g., TYPE $I). Table 1-2 defines the System Variables. 


Table 1-2 
MUMPS-11 System Variables 


SAddress SA is used with device I/O. When DECtape is the 
currently ASSIGNed device, SA contains an 
integer which is the address of the next 
character to be read or written (range of 
SA=0-294,911). When magtape is the currently 
ASSIGNed device SA contains an integer whose bit 
pattern displays the Magtape Hardware Status 
Register (drive status register for the TJUI16). 
When the Sequential Disk Processor is the 
currently assigned device, SA contains either 
the current disk block address or the error 
status. When a terminal is the currently 
assigned device, SA contains the error status. 
When another processor (CPU) is the currently 
ASSIGNed device, the low order byte of SA 
contains a count of unsuccessful I/O 
transmission (message state only), and the high 
order byte describes error conditions (message 
and terminal state). Refer to the MUMPS 
Programmer's Guide, for bit assignments. 


When the Sequential Disk Processor is the 
currently assigned device, $B and $H contain the 
location (byte address) of the next character to 
be read or written, according to the formula. 


ADR = SH*256+SB 
Where SH = 0 or 1 (page) 
and $B = n, 0 <n<255 (byte in page) 


SDate contains the date as an integer in the 
form: 


(yy*500) +ddd 
where: 


yy = Year - 1900 
ddd = Number of days since Dec 3l 


This value is incremented by one when the ST 
variable is incremented to midnight (86,400 
seconds). 


SError The system sets the contents of SE to negative 
nve which denotes’ the type of error incurred. 
The programmer may optionally set this variable 
to an spn to control his own error processing. 
Refer to the MUMPS-11 Programmer's Guide _ for 
details. 


Variable Name 


SHalf 


SI/O device 


SJob Status 


SLocation 
SRandom 
Storage 
STime 
SWhere 


SX coordinate 
SY coordinate 
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Table 1-2 (Cont.) 
MUMPS-11 System Variables 


Description 


See SByte. 


$I contains an integer which is the number of 


the device which is currently ASSIGNed (i.e., as 
specified by the last argument of the last 
ASSIGN command issued). At log-in time, SI 
contains the I/O device number of that terminal 


(Principal I/O Device). After a System Error, 


or UNASSIGN and ASSIGN commands, $I is set to 
the number of the principal device. 


SJ contains a number, some of the bits of which 
specify the current status of programming mode, 
CTRL C/BREAK recagnition, and timed READ 
overruns. In addition, the ASSIGN and PRINT 
Commands can be used to alter the bits in SJ 


that control the reception or inhibition of CTRL 


C or BREAK, the updating of Library Programs and 
Library Globals, and the writing of memory or 


disk locations via the VIEW Command. Refer to 


the MUMPS-11 Programer's Guide for SJ bit 


assignments. | 


$L contains the number of the program step 


currently being executed. 


SR contains an integer in the closed interval 6 
to 32767. The value of $R in this interval is 


effectively random and changes with each 
reference of SR. 


$S contains an integer which is the number of 
free byte (character) locations remaining in the 


user's partition. 


$T contains an integer which is the number of 


seconds elapsed since midnight (range = 0 - 
86,399). $T is incremented each second. 


“The system sets $W to the value of $L when an 
error occurs and the user had previously SET SE. 
If the user does not SET SE, SW contains 0. 


SX and $Y are the x and y coordinates (output 
only) of the print-head or cursor position on 
non-mass storage I/O devices, such as_ the 
terminals, line printer and paper-tape punch. 


When a CPU-CPU device operating in message state 
is the currently assigned device, $X contains 
the current message number in the range 1 - 15. 
This number is incremented by one each time a 
message is transmitted successfully. When the 


count reaches 15% the next successful 


transmission resets the count to 0. $Y is not 
used and does not contain meaningful 


information. 
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EXPRESSIONS 


The term expression refers to the whole range of value descriptions 
which can be made in the MUMPS language. An expression is any legal 
combination of elements (operands) and operators. Expression 
elements include such basic language elements as literals, constants, 
Simple variables and subscripted variables (including Global Variables 
and System Variables). Also included in this category are function 
references (defined in Chapter 4), and subexpressions, which are 
Simply expressions enclosed in parentheses. 


The following are examples of expression elements: 


123.34 Constant 

ABC Simple Variable 

"ABCD" Literal 

MX (5) Local Subscripted Variable 
tXYZ (2,45.2,D) Global Variable 

SROOT (POR) Function Reference 

(A+B (C/D)) Subexpression 


The operators in an expression serve to represent various arithmetic, 
string, and logical operations of the MUMPS language. All operators 


except minus (-) and Boolean NOT (') are binary operations and 
therefore require two operands. The minus (-) and Boolean NOT 
operators are unary operations and require one operator only. Tables 


2-1 and 2-2 list the MUMPS-11l expression operators. 


The following are examples of MUMPS expressions: 


A 
234.53 
A*B- (C/D) 


"10 CATS"@"SUP BOTTLES" 

"15 DOLLARS"+AMT/NET 
TOT=6.21/CD- (SROOT (G*RT/MQ) ) 
A=C+V&X>S-TIAMT=5 
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Table 2-1 
Summary of Numeric Expression Operators 


Arithmetic + Addition 
~ Subtraction 
* Multiplication 
7 Division 
# Modulo 
x Integer Division ° 


Minus (Unary) 


Less Than 
Greater Than 
Equality 


Relational 


Less Than or Equal To 


OVIHIONUIVA 


Greater Than or Equal To 


Greater Than or Less Than or Not 
Equal To | 


Boolean 


(apostrophe) NOT (Unary) 


Table 2-2 
Summary of String Expression Operators 


Relational 


Contains 
Follows 
Pattern Verification 
Equality 


Concatenation Concatenation 


Intervening spaces between expression elements and operators are not 
permitted. 
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The following paragraphs explain the rules that govern the formation 
of expressions like those above and how MUMPS interprets them. 


2.1 RULES FOR FORMING EXPRESSIONS 
The following rules apply to the formation of all expressions: 


1. Literals, constants, variables, functions, and subexpressions 
are expressions. 


2. If A and B are expressions, then the following are 
expressions: 


a. A binary operator B 
b. Unary operator A 
oer (A) 


3. There are no expressions except those defined by l. and 2. 
above. 


2.2 DATA MODES 


In the MUMPS language there are essentially two types or modes. of 
data, numeric and string. Each of these data types is defined in 
Chapter 1. To summarize, numeric data are signed fixed-point 
quantities with two decimal places and are within the range 
+21474836.47. String data are simply ASCII character groupings of 132 
characters or less. 


Internally, MUMPS uses a third format commonly denoted double 
precision floating point format for storing the results of a SM 
function calculation. In the description on the following pages of 
expression evaluation, wherever a numeric to string value conversion 
is indicated, a floating point number is allowed, and the floating 
point value would be converted to a string value. However, conversion 
of a floating point number to a fixed decimal number is not allowed. 
Thus, although floating point numbers can be used with string 
operators, a floating point number cannot be used with arithmetic 
operators outside of a SM function, and care should be taken when 
using the equality operator with a floating point number. 


All expression operators except concatenation produce numeric results. 
In the case of expressions which use Relational or Boolean operators, 


evaluation produces either a True or a False result, which is 
represented in numeric form as either -0.01 (True) or 0 (False). 


2.3 RULES FOR EXPRESSION EVALUATION 


2.3.1 Order of Evaluation 


All MUMPS expressions are evaluated in strict left to right order. 
There is no precedence among the expression operators except that a 
unary minus is evaluated before a Boolean NOT when they appear as 
adjacent operators. 
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2.3.2 Setting Precedence 


Additional precedence is established through the use of parentheses. 
Parentheses are used to form subexpressions which are evaluated as a 
Single element of the expression in which they appear. Within 
parentheses, evaluation is performed as described above. 7 


Example: > 


(Where: R=intermediate result) 


in the expression B+C/D*E evaluation is: 


B>R, 

R,+C> R, 
Ry. 7D 
R, *E> R, 


Adding parentheses to the same expression, B+(C/D)*E results in the 
division being performed prior to the addition as shown below: 


B-+R, 
C/D>R, 
Rytk, > R, 
R,*E 7K. 


Additional levels of precedence can be achieved by the nesting of 
subexpressions. oo 


Although 
physical 


Lk 


Ze 


there is no logical limit to the depth of nesting, there are 
limits. These are: : | 


Physical line length - not more than 132 characters can _ be 
used to construct the command line in which the expression 
resides. | | : 


Size of partition in which program is running - each level of 


nesting uses four words of storage during evaluation. 


Example: 


Where: (R=intermediate result) — . 
| in the expression B+((C/D)*E), evaluation is: 


B>+Ry 
C/D +R, 
R, *E +R, 
R, +R, >R, 


The precedence of evaluation between several subexpressions at the 
same level in an expression is also strictly from left to right. 


Example: 


Where: (R=intermediate result) 
in the expression C-(X*Y)+W/(E-M), evaluation is: 


C7>R 


X*Y >R, 
Ry-R, +R, 
R,+W +R, 
E-M >R, 
R,/R, >Rs | 
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2.3.3 Automatic Data Mode Conversion 


During expression evaluation, operands are converted as required from 
numeric to string data and vice-versa to conform to the data mode 
requirements of the associated operator. This process does not, 
however, alter the original mode of stored data (i.e., data in 
variables, literals, or constants). 


Numeric values are converted to the equivalent string representation 
for string operations. A numeric value of 123.4 would be converted to 
the characters: 123.4. 


String values are converted to numeric values for numeric operations. 
All leading numeric characters in the string, including +, - and 
decimal point (.), are changed to the corresponding numeric quantity 
within the range of MUMPS numbers. The first character that does not 
conform to the format of a MUMPS number terminates the conversion 
process; the accumulated value is taken as the result. Any leading 
zeroes in the resulting numeric value are discarded. Strings that do 
not contain leading numeric characters produce a 0 result. Thus: 


12ABC +12 ~1.52A.B+> -1.52 
ABC12 +0 -52A 70.52 


-1.011A +MINIM error 002.5X7>2.5 


2.3.4 Data Mode Of Results 


The last operator in an expression determines the data mode of the 
result, either numeric or string. | 


Examples: 
A/B@C +String Result 
| een 
last operator 
A@B/C >+Numeric Result 


, 
last operator 


2.3.5 Trailing Operator 


An expression may contain a trailing operator to effect a change in 
the final result of evaluation from numeric to string and vice-versa. 
A plus (+) sign causes conversion to a numeric value and a commercial 
at (@) Sign, which is also the concatenation operator, causes 
conversion to a string value. 3 
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2.4 OPERATOR DESCRIPTIONS 


The following paragraphs specifically define the operations performed 
by each operator and show the data modes of both the operands and the 
results. Examples are also included where additional clarification is 
necessary. The mnemonics listed below are used as a shorthand 
notation in each description. © ‘ | | 


Mnemonic : | Definition 
nv Numeric Value - this is a numeric quantity which may 


be either an intermediate or a final result. 


SV 7 String Value - this is a string quantity which may be 
- either an intermediate or a final result. 


nvel Numeric Valued Expression ELement - this is a single, 
identifiable numeric quantity that may be indicated 
by a local or global variable, a literal, or result 
from evaluation of a function or sub-expression. 


svel String-Valued Expression ELement = a single 
| identifiable string guantity that may be indicated by 
a variable. or literal, or result from evaluation of a 

function or sub-expression. 


2.4.1 Arithmetic Operators 


The arithmetic operators permit arithmetic computations to be 
performed. The symbols are defined as follows. 


Legend: 
Symbol. | Operation 
+ Addition. — 
= Subtraction | 
* Multiplication 
/ Division 
it Modulo - When both arguments of this operator are 


positive, the resulting value is the remainder after 
integer. division. More formally, A#B is defined to 
Be ° SG. 2, | | 


_ A-(A\B*B) + (absolute value of B if A<0O) 
The result is insensitive to the sign of B, and it is 
always positive. | | 
\ «Integer Division - The result is the same as normal 
division except that the decimal portion is 
truncated. : 
Binary Forms: e 


+ a we A. direct evaluation of the nvel is made. 


- The operation is performed and a numeric 
nv nvel+nv result produced. 

7 

# 

i 
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+ 


The svel is evaluated and the result is 
converted to a numeric value. The 
nv svel+nv operation is performed and a numeric 


result produced. 

Va 

# 

\ 

+ The sv iS converted to a numeric value. 

- The operation is performed, and a numeric 
SV nvel>nv result produced. 

* 

# 

\ 

+ The sv is converted to a numeric value. 


The svel is evaluated and the result 

SV svel +nv converted to a numeric value. The operation 
is performed, and a numeric 

result produced. 


“ te 


Unary Forms: 


When the minus (-) iS used aS a unary operator to indicate negation, 
it may prefix any element in an expression. Thus: 


-nvel+nv The resulting nv has a different sign but the = same 
absolute value. 


-svel +snv The svel is converted to a numeric value then treated 
as above. 


Examples: 
Where: A=3; B=5; C=12; D=6 
1. A+B- (C/D) > 6 
2. A+B-C/D>-0.66 
Se BS 33 
ae S345 22 
5. 3.4\1.4 72 
6. "3214 MAIN ST"-802 +2412 
Analysis: 


"3214 MAIN ST" + 3214 
3214-802 +2412 


Le 239"CAT™ 0 Since there are no leading numeric characters 
in "CAT", it is evaluated as numeric 0. 
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Analysis: 


"CAT" +0 
23*0>0 


8. "1234ABCDE6789"/"0002POIU" +617 
Analysis: 
"1234ABCDE6789" +1234 


"OO002POIU" +2 
1234/2 +617 


2.4.2 Relational Arithmetic Operators 


The relational arithmetic operators permit the comparison of numeric 
Or string quantities in an arithmetic manner. The results’ of 
expressions uSing these operators are either -0.01 to represent a True 
relation or 0, to represent a False relation. 


Legend: 
Symbol | ' Operator 
< 'Less Than' comparison 
> "Greater Than' comparison 
<= | 
or | | 'Less Than or Equal To' comparison 
=< 
>= 
Or "Greater Than or Equal To' comparison 
=> 
<9 
Or "Greater Than or Less Than' or ‘Not Equal To' 
>< comparison | 
Forms: 


< A direct evaluation of the nvel is 
> aa made and the operation is performed. 
nv >= |nvel +True or False A numeric result is produced, -0.01 
<= (True) or O (False). 
< 


> 
>< 
< The svel is converted to a numeric 
> _ : value and the operation is 
nv >= |svel>True or False performed. A numeric result 
< > _e % 7 is produced. -0.01 (True) or 0 
>< (False). 


< The sv iS converted to a numeric 

> value and the operation is 
SV <= |jnvel +True or False performed. A numeric result is 

>= produced. -0.01 (True) or O (False). 
< 
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< The sv and svel are converted to 

> numeric values and the operation 
SV >= | svel>True or False is performed. A numeric result is 

>= produced -0.01 (True) or 

< > 0 (False). 


>< 
Examples: 
Where: A=3; B=5; C=12; D=6; X=10 
l. A+B>C/D >0 (False) 
Analysis: 
A+B > 8 
8>C + 0 
0/D +0 
2. A+B>(C/D) +0.01 (True) 
Analysis: 
A+B >8 


C/D +2 
8>2 >+0.01 (True) 


3. "3214 MAIN St" <=802>0 (False) 
Analysis: 


"3214 MAIN ST" > 3214 
3214<=802 +0 (False) 


4, 25*"CAT"< >67%-0.01 (True) 
Analysis: 
W CAT ih) _> 0} 
25*0 +0 
O< >67>-0.01 (True) 
5. "23TSV"+"XYZ"<"78.04FARGH"+3 >+2.99 
Analysis: 
"23TSV" >2.3 
"XYZ" +0 
23+0 +23 
"78.04FARGH" >+78.04 
23<78.04> -0.01 (TRUE) 
=0 0143 %2.99 
6. X>A>B >0O (False) 


Analysis: 


10>3>-0.01 (True) 
-0.01>5 +0 (False) 
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2.4.3 Relational Equality Operator (Arithmetic or String) 


Relational Equality operations are signified by the use of the equal 
Sign (=), and can be considered either arithmetic or string in nature, 
depending upon the type of operands used. The results of expressions 
uSing this operator are either -0.01 (True equivalence) or 0 (False 
equivalence). 


Care should be taken when uSing a floating point number (created by a 
SM function) with the equality operator. In such cases, the following 
rules govern. 


1. If the lst argument is a floating point number, it is 
interpreted as a string value. 


2. If the 2nd argument is a floating point number and the Ist 
argument value iS a fixed decimal numeric value, a MIXED 
error is generated. 


3. If the 2nd argument is a floating point number and the lst 
argument's value is a string value, a string conversion of 
the 2nd argument occurs. 


The definition of equality when used with strings or fixed decimal 
numbers is given below. 


Legend: 
Symbol Operation 


= Numeric or String Equivalence 
Forms: 


nv = nvel->tTrue or False A direct evaluation of the nvel is 
made and the operation is 
performed. A numeric result is 
produced, -0.01 (True) Or 0 
(False). 


nv = svel>True or False The svel is converted to a numeric 
value and a numeric comparison is 
made. A numeric result is produced 
-0.01 (True) or 0 (False). 


Sv = nvel >True or False The sv is converted to a numeric 
value and a numeric comparison is 
performed. A numeric result is 
produced -0.01 (True) or QO (False). 


Sv = svel >True or False The svel iS compared with the Sv on 
a character-by-character basis. A 
numeric result is produced -0.01 
(True) or O (False). 


NOTE 


The > or < operator cannot be used to 
make non-numeric string comparisons. 
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Examples: 
Where: A=3; B=5; C=12; D=6 
1. A+B=C/D +0 (False) 
Analysis: 
A+B +8 
8=12 +0 (False) 
0/6 +0 
2. A+B=(C/D) +0 (False) 
Analysis: 
A+B +8 
C/D +2 
8=2 +0 (False) 
3. "5D0GS"*5=25+-0.01 (True) 
Analysis: 
"SDOGS" +5 
5475-225 
25=257+-0.01 (True) 
4, -—3+2="ABCD234" +0 (False) 
Analysis: 
-3+27> -] 
"ABCD234" +0 
-1=0 +0 (False) 
5. "JACOBS"="JACOB" +0 (False) 


Analysis: 


The string JACOBS is not equal to the string JACOB. 


2.4.4 Relational String Operators 


The relational string operators provide facilities for determining the 
characteristics of string data. Results of expressions uSing these 
operators are either -0.01 to represent a True relation or 0O to 
represent a False relation. 


Symbol Operation 
[ String Contains - The string specified by left operand is 


examined for the occurrence of the string specified by the 
right operand. If a match is found the result is True 
(-0.01); otherwise the result is False (0). 


] String Follows - The string specified by the left operand is 
compared character-for-character with the string specified 
by the right operand to establish relative position 


according to the MUMPS collating sequence. (Refer to 


2244: 


Symbol 


Forms: 


nv 


nv 


SV 
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Operation 
Appendix B.) If the string specified by the left operand 
"follows" that specified by the right operand, the result is 
True (-0.01); otherwise the result is False (0). 
Pattern Verification - The string specified by the left 
operand is examined for the occurrence of the character 
patterns specified by the Pattern Specification Codes (psc) 
contained in the right operand. If a matching condition 
exists the result is True (-0.01), otherwise the result is 
False (0). Pattern Specification Codes may be preceded by a 
Single decimal integer (n) in the range 0 - 9 to specify the 
number of occurrences of a particular character type. If 0 
is specified, the associated character type is ignored. If 
no number is specified an indefinite number of characters of 
the specified type are accepted. 
Code Meaning 
A Verify upper case alphabetics 
B Verify lower case alphabetics 
C Verify upper and lower case alphabetics 
D Verify numerics : 
M Verify numerics and upper case alphabetics 
N: Verify numerics and lower case alphabetics 
O Verify numerics and upper and lower case alphabetics 
P Verify punctuation 
Q Verify punctuation and upper case alphabetics 
R Verify punctuation and lower case alphabetics 
S Verify punctuation and upper and lower case 
alphabetics | 
a Verify numerics and punctuation 
U Verify numerics, punctuation and upper case 
alphabetics — 
V Verify numerics, punctuation and lower case 
alphabetics 
W Verify any character 
All characters which are not strictly alphabetic or numeric 
are conSidered to be punctuation. Literals may also be used 
to verify the occurrence of specific characters in a string. 
. . The nv is converted into its string 
nvel +True or False equivalent. The nvel is evaluated 
| 7 and the result converted into its 
string equivalent. The comparison 
is made, and a numeric result 
produced: -0.01 (True) or 0 
(False). 
: The nv is converted into its string 
svel+True or False equivalent, the comparison is made 
4 and a numeric result produced: 
-0.01 (True) or O (False). 
<a | | The nvel is evaluated and the 
nvel +True or False result is converted to its string 
] i oo | equivalent, the comparison made, 


and a numeric result produced: 
-0.01 (True) or O (False). 


2712 
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[ The comparison is made and a 
SV svel+ True or False numeric result produced: 
] -0.01 (True) or O (False). 
CAUTION 


If the svel is not a variable or literal 
(i.e., it results from the evaluation of 
a function or subexpression), there is a 
possibility that the internal string 
accumulator used by the expression 
evaluator, may overflow thus terminating 
program operations with a MXSTR error. 


SV?n psc, n psc,... *True or False The string is examined in 
accordance with the pattern 
specification code(s) to the 
right of the operator anda 
numeric result is produced: 
-0.01 (True) or OG (False). 


Nnv?n psc,n psc, ... +True or False The nv is converted to its 
string equivalent, the string 
is examined in accordance with 
the pattern specification 
code(s), and a numeric result 
is produced: 0.01 (True) or 0 


(False). 
Examples: 

1. Where: A = 3; B = 500 

A+B[50 + True 

Analysis: 
A+B > 503 
503 > 503 convert numeric to string 

50> 50 convert numeric to string 

503[507+-0.01 (True) string 503 contains 50 


2. Where: A "ADAMS JO” 
B "ADAMS JA" 
Aj]B> -0.01 (True) 


Analysis: 


The left string iS compared on a character for 
character basis to the right string. The result is 
True since "Q" follows "A" in the collating sequence. 
(Refer to Appendix B.) 


Where: A = "JONES J" 
B = "JONES og" 
A]B+False 


Analysis: 


The comparison is made as above but a False result is 
produced since the strings are identical. To 
absolutely establish equality, a relational equality 
operation must be performed. Thus A=B +True. 
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3. Where: DAT = "04/23/72" 
DAT?2D"/"2p"/"2p + -0.01 (True) 


Analysis: 


The string contained in DAT is examined for a pattern 
consisting of 2 numeric characters followed by a 
slash (/) followed by 2 numeric characters followed 
by another slash ee followed by 2 numeric 
characters. Note the use of literals to verify 
specific characters. 


2.4.5 String Concatenation Operator 


The string concatenation operator (@) permits the joining together 
(concatenation) of expression elements to form strings. The string 
vaue represented by the right operand is appended to the string value 
represented by the left operand. 


Forms: 

nv@nvel +sv The nv is converted to its string equivalent. The 
nevel is evaluated and the result is converted to 
its string equivalent. The operation is performed 
and a string result produced. 

nv@svel > sv The nv iS converted to its string equivalent and 
the svel is evaluated. The operation is performed 
and a string result produced. 

sv@nvel > sv The nvel is evaluated and the result is converted 
to its string equivalent. The operation is 
performed and a string result produced. 

sv@svel + sv The svel is evaluated, the operation performed, 


and a string result produced. 
Examples: 


Ll. "CAT"@"SUP" +CATSUP 


2. Where: MO = 4 
DA = 22 
YR = 72 


MO@"/"@DAG"/"YR 74/22/72 


3. Where: B 
C 


6 
2 


"THE RESULT IS "@(B>C) +THE RESULT IS -0.01 


2.4.6 Boolean Operators 


The operators described below permit the construction of Boolean 
expressions using the AND (conjunction), OR (disjunction) and NOT 
(logical complement). 
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Operator Operation 
& AND - forms the Boolean AND (logical product) of 


the operands 

! OR - forms the Boolean inclusive OR (logical sum) 
of the operands 

'(apostrophe) NOT - forms the logical complement of the operand 
(unary operation) 


Boolean Truth Table 


Where: True = -0.01 
False = 0 
N = any number including True and False 
M = any nonzero number 


AND OR NOT 

True & True=True True! True=True 'True=False 
True & False=False True! False=True "False=True 
False & True=False False! True=True '"M=False 
False & False=False False! False=False 
N &True N! True 

=N =True 
True & N True! N 
N & False N! False 

=False =N 
False & N False! N 


The AND and OR operations are performed on a bit-by-bit basis on _ two 
32-bit quantities which allows either simple evaluation of True and 
False quantities or complex masking operations (by knowledgeable 
system programmers). The NOT operator is a logical rather than a 
bit-by-bit complement. As shown above, the complement of a False (0) 
value is True (-0.01) but, by convention, the complement of any 
non-zero guantity, including True, is always False (0). A true 
bit-by~-bit complement of a value can be accomplished using unary 
minus, thus: 


-N-0.01 
All operands used with Boolean operators are assumed to be numeric. 
Operands which are string values are evaluated and converted to a 
numeric value in accordance with the rules for mode conversion (see 


Section 2.3.3). The results of Boolean operations are always numeric. 


Binary Forms: 


& The operation is performed and a numeric 
nv nvel +nv result produced. . 

! 

& The svel is evaluated and the result 


! operation is performed and a numeric. result 
produced. 


nv | svelonv converted to a numeric value. The 


& | The sv is converted to a numeric value; the 
SV nvel+nv operation performed, and a numeric 
! result produced. 


svel +nv svel is evaluated and the result is converted 
to a numeric. value. The operation is 
performed and a numeric result produced. 


" The sv is converted to a numeric value. The 
SV 


Z2=15 


Unary Forms: 


EXPRESSIONS 


NOT is a unary operator and may prefix any element in an expression. 


"nvel -nv 


'svel +nv 


Examples: 
Where: A = 4: B = 2: 
1. (ADB) & (A<X) 


Analysis: 


4A>2>- 


The nvel is evaluated and, if the result 


is 


either True or False, its sense is reversed, 
Any other value of the nvel produces False. 


The svel is evaluated and its result 


is 


converted to a numeric value. If the value 


is either True or False, its sense 


reversed. Any other value produces False. 


+ 0.01 (True) 


0.01 (True) 


4<@>+-0.01 (True) 


True & 


True +-0.01 (True) 


2. '(AtC) 1 ('X="C) £("12CATS">"10") + -0.01 (True) 


Analysis: 


44+3457 
'7>0 
'8>0 
'3>0 
0-0-0 


0!0 >+False 

"LZCATS" +12 | 
12>10 +-0.01 (True) 
0!-0.01+-0.01 (True) 


20467 Trailing Data Mode Operators 


is. 


A trailing operator may be appended to the last element in any 
expression to ensure the data mode of the final results of 


expression. 
Operator 


@ 


| Operator 


Convert the data. mode of the expression result 


a string value. 


Forms: 
Svt+ >nv 


nv+t+ >nv 


Convert the data mode of the expression result 


a numeric value. | | | 


- The sv is converted to its numeric equivalent. 


The operation is ignored since the operand 


already numeric. 


nv@ >+Ssv 


The nv is converted to its string equivalent. 
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Sv@>sv The operation iS ignored since 


Examples: 


Where: A 


already a string. 


= 100, B = 2, C = "00" 
A+B@ + "102" 
A>Be + "-0.01" 


A/B@C+ + 5000 


the 


operand 


is 


CHAPTER 3 


COMMANDS 


INTRODUCTION 


A command is the principal algorithmic component of the MUMPS language 
and consists of one or more elements the first of which is a mnemonic 
that characterizes the action or procedure to be performed. 


Examples: 
GOTO, READ,SET,OVERLAY 


Any remaining elements in a command are arguments and their 
delimiters, and special symbols. Arguments specify a logical entity, 
such aS a variable or expression to or upon which the action of the 
command is directed. 3 


3.1 RULES FOR COMMAND SYNTAX 


l. Commands which are to be executed immediately (Direct Mode) 
do not use Step Numbers. The first character of the command 
is the first character on the line following the system's 
right angle bracket (>) prompting symbol. 


2. Commands which are to be executed as part of a stored program 
(Indirect Mode) are preceded by a Step Number. A command is 
separated from a Step Number by a Single space. 


3. Each command may be abbreviated to its first letter. 
Furthermore, to do so savesS partition space since only the 
first character is necessary but all succeeding characters up 
to the next space (g.4) character are stored. Care should be 
used when abbreviating commands to avoid confusing certain 
commands which are executable only in Direct Mode with others 
which can only be executed in Indirect Mode. For example: 


Eeww2-5 
In Direct Mode it means: ERASE step 2.5. In Indirect Mode 
it is read as: ELSE, and produces a syntax error, since 2.5 
is not a valid command. 


4. A command is separated from its argument or argument list by 
a Single space. 


5. Multiple arguments to a command are separated from each other 
by commas. 


10. 


11. 
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Multiple commands on a line must be separated from each other 
by a Single space. 


Certain commands permit the optional use of an argument or 
argument list. Note that the ELSE command is an exception, 
only one intervening space iS allowed. If such a command is 
not the last command ona line, and is to be used with no 
argument list, it must be separated from the next command by 
two spaces. 


Program comments may be appended to say command line. When 
used, they must be preceded by a semicolon (;). The 
semicolon may be separated from the preceding command 
argument list or Step Number by an optional space. 


The indirection syntax operator, symbolized by either 
underscore (__) or back arrow (+), provides dynamic command 
argument definition. In form, a command's argument is 
replaced by the symbol —. or <« immediately followed by a 
variable name. The variable must contain a string that is a 
syntactically correct argument Or argument list. The 
argument(s) can be followed by one or more commands and their 
arguments (excluding the QUIT command). During execution, 
the contents of the variable are interpreted accordingly.’ 


Example: where: ARG = "15+3/6" 


1.20euTYPEL,*ARG - The contents of ARG are © 
evaluated as the argument and the result is 3. 


An optional Boolean Valued Expression preceded by a _ colon 
(:bve) can be used to specify. conditional execution of 
certain commands and command arguments. | 


Examples: 2.03e5GOTOwu3:A>B - control is transferred to Part 
3 if the contents of 'A' is greater than the contents of 'B'. 


10.2leuWRITE:A=BLy2 - If A=B, all the Steps in Part 


2 are written out to the currently assigned I/O 
device. 


The colon can also be used to specify alternate forms of 
certain commands.? 


Example: 6.30 cuREADWuX:5 - is a 'timed' READ. 


1. Refer to Section 3.3.13 for further information on the indirection 
syntax. | 


Ze 


Refer 


either to Table 3-1 or to the specific command descriptions 


(Sections 3.3.1 through 3.3.27) to determine the applicability of 
this feature. 
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3.2 FORMAT CONTROL 


The following special symbols are used with the PRINT, READ, and TYPE 
commands to effect format control: 


Symbol Description 
# Number sign is used as a format ccntrol 


character to initiate a Page Feed or a FORM 
Feed on an output device. 


! Exclamation point is used as a format control 
character to initiate a Carriage-RETURN-LINE- 
FEED (CRLF) sequence on an output device. 


? Question mark specifies horizontal tabulation 
(output only) on devices such as the 
terminals, line printer and paper-tape punch. 
The ? symbol is followed by a nve to specify 
the number of spaces from the absolute left 
margin. Form: ?nve. 


When these symbols appear consecutively on a line, the intervening 
commas, normally required to separate command arguments, can be 
omitted. 


3.3 DESCRIPTIONS OF MUMPS COMMANDS 


MUMPS commands fall into six functional groups as shown in Table 3-1 
below. The following paragraphs describe each command and its 
argument. Examples are provided for clarification. The commands” are 
presented in alphabetical order for easy reference. 


COMMANDS 


Table 3-1 
Functional Relationship of MUMPS Commands 


Assignment Commands Assign and deassign values to symbolic 
representations. | 


Set \:bve} ws Var=expression,... 


a4 {sve} I variable,... 


Xkill {sve ens LV AL ysis 


Control Commands Govern the sequence in which commands Steps, 
Parts, and related programs are executed. 


Goto {:bve | ws spn {:bve } ee 


Do {rbve } | =pn | sbve} 


svl een 
Tf DVere sy next command 
td ed 
For wy ivar= {ave \:nve, inves} reat jnve1 :nvey bt 
Hiss 2 bve } 3 Next command | 


Else ws next command 

Call \:bve } 3 pPNnam {:spn} pe aus 

Overlay {zbve ws pnam {:spn} 

Start {: pve } ws pPpnam \(nve)} \:spn ee 
Quit {rbve} 

Hang \:bve | i nve {Fbve } ee 


Halt {:bve bed 9 teed 
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Table 3-1 (Cont.) 
Functional Relationship of MUMPS Commands 


Input/Output Commands Direct the input and output of data to and 
from the various devices in the hardware 
environment. 

( enteialiie! 
wwii format 
Type {:bvel en apie ee 
Led 


lvar ‘ nve 


Read {:bve | is literal pera s 
format 
nve 

Print \rbve } ad literal|] ,... 
format 


Write {pve | } fs {:spna | pees 


| 


:sve{:nve3{:nve,}} | 
snveo{:nve;} 


ygeuse 


nve, 
Assign \:bve } i! oe 


Unassign {:bve} oy» NVE,... 


Editing Commands Permit the examination, modification, and 
| storage of MUMPS programs. 


Spn: Sve; Sve 


Modify \:pve} _ | cee eve 


Erase {:bve | ae cia 
a 


COMMANDS 


| | Table oes (Gone: ) 
| Functional Eereesepenee, of MUMPS Commands 


Debugging Commands : Facilitate the creation and maintenance of 
a 7 _ MUMPS programs. 


System I/O Command — | ‘Permits privileged modification of core and 
3 disk memory by MUMPS System Programs. 


View {rpve } us nve; {:nvez | pekshe 


Timesharing Commands Permits database protection through a 
| ° RAlerarchical interlock by applications 
‘program convention. 


Lock {:bve } rere 4 -(gvar rave {:nve} | pees 


Unlock {rbvebuw os 5 
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ASSIGN 


3.3.1 ASSIGN Command 


Mode: Direct or Indirect 


Syntax: nve, hobo gtk aa | 


Assign {:bveh, sped inve, {:nve; 


Description: 


This command permits one or more I/O devices (DECtape, Magtape, Paper 
Tape, Line Printer, Sequential Disk Processor and terminals) to be 
reserved for the exclusive use of a program (Indirect Mode) or 
programmer (Direct Mode). The last device specified in the argument 
list is made 'current' by setting the partition's SI System Variable 
to that number (refer to Section 1.6.8). This means that subsequent 
I/O commands, such as READ, TYPE, WRITE, and PRINT, are directed to 
the '‘'current' device. Other devices specified in the argument list 
though not ‘'current' are ‘owned' and are not available for use by. 
other programs in different partitions. 


Each device is asSigned in the sequence specified by the argument 
list. If all assignments are successful, the next command on the line 
is executed. If an assignment is not successful (i.e., a device is 
"owned" by another job), this job is suspended and the remainder of 
the argument list is not processed. When the device becomes 
available, job suspension terminates and argument list processing is 
resumed. 


NOTE 


Devices not currently "owned" should be 
asSigned in numerically ascending order 
to avoid conflicts with other jobs 
competing for the same devices. Failure 
to follow this procedure can cause _ two 
Or more of the competing jobs to hang. 


Each argument (nve,) must specify a legal device number (refer to 
the MUMPS-ll Programmer's Guide). Device 0 always refers to the 
Principal I/O Device (i.e., the terminal that initiated program 
operation). The use of illegal device number or numbers for 
nonexistent devices causes a NODEV error and immediate program 
termination. : 


The use of the optional arguments "nve,", "nve3", and "nve," 
depends on the device specified by nve, If nve, is a terminal 
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(device 1-19 and 64-111), then nve, may be used to controti the right 
margin of output to the terminal. It specifies the maximum number of 


characters to output on any given line. Margin control remains in 
effect until either an UNASSIGN command or another ASSIGN command 
(nve, = 0) is issued. If the user wishes to affect margin control for 
the Principal I/O Device, nve, must be the actual device number of 
that terminal - not device 0. 

If nve, is a CPU-CPU device, the optional ":bve" may be used _ to 


change the state of the CPU driver. If the bve is True (non-zero 
result), the CPU driver enters the message state. If the bve is False 
(zero result), the CPU driver enters the terminal state. The default 
State is terminal state. The device remains in its current state 
until another ASSIGN directing a change of state is executed. When 
the device is UNASSIGNed, it is reset to the terminal state. 


If nve, is a DECtape device, then nve, may be used to specify the 
location (byte) of the next character to be read or written. The 
specified value is entered in the SA System Variable. Legal values 
for i:nve, for DECtape are in the range 0-294,911 (integer). When 
reading or writing seguential records, nve, need not be specified in 
Subsequent ASSIGN commands since the system keeps track of the current 
tape position automatically. | 


Tf Ave: is a magtape device, then sve may be used to modify the tape 
format. for subsequent Magtape I/O. Each character in sve represent a 
Switch according to the following table. 


Switch Character -Effect 

A | ASCII character set 

D CDOS-11 compatible format 

E EBCDIC character set | 

F Fixed lenath logical record 

L Standard Labeling (ANSI or IBM) 

S Stream data format , 

U Unlabeled 

V Variable length logical records (ANSII 

EDN, oTBM "VV" format) 

digit | 7 | Density bits specification 
Nve, may be used to specify a fixed length logical record size in 
bytes; a Qinnve, is used for stream or variable length records. 
Nve, is required if the fixed length record option is being used. 


Nve, may be used to specify the physical block size in bytes of data 
blocks. Nve, can range from 140 through 512. When the Assign 
command is used to establish ownership of a magtape drive, a default 
tape format is assumed which can be immediately modified for the 
duration of ownership by the optional Assign arguments. Optional 
arguments of subsequent Assigns which merely route I/C to the drive 
are ignored. 


Further information regarding the effect of the Assign command on 
Magtape operations can be found in the Magtape section of the MUMPS-11 
Programmer's Guide. 


1f nve, is a Sequential Disk Processor, then nve, may be used _ to 
specify the location (byte address) of the next character to be read 
Or written. Legal values for nve, for the Sequential Disk Processor 


are in the. range 0-511. The specified value is entered in the $B and 
SH System Variables according to the formula: 


COMMANDS 


ADR=SH*256+SB 
where SH=0 or 1 (page) 
and $B=n, O<n<255 (byte in page) 


If nve, is a Sequential Disk Processor and nve, is specified, the 
optional argument 'nve3;' may be used to specify the disk block 
address. The value is entered in the SA System Variable according to 
the formula. 


nve 3=TYP*2 ,097,152+ (UNT*262,144)+BLK 


G. for RA LL 
where TYP (device type)= 1 for RFl1l 
‘ 2 for ‘RPI 

‘ 3 for RJPO4 


UNT (unit number) =m,0<m<7 


4799 for RKl1 
1023 foc RFII 
BLK (block address on unit) =n,0<n< 79,000 for RP11(RPO3) 
an 39,999 for RP11(RPO2) 
170,543 for RJPO4 


As with the DECtape operation, the system also keeps track of the 
position of the current record on the SDP device after the initial 
ASSIGN command. Thereafter, nve, and nve, need not be specified 
in subsequent ASSIGNs when performing sequential I/O. 


The "O:bve" argument permits enabling and disabling of the CTRL C_ and 
BREAK control characters originating from the Principal I/O Device and 
from all currently "owned" terminals. When a user logs into the 
system using the Programmer Access Cede (PAC), CTRL C and BREAK are 
enabled. When the PAC is not used, CTRL C and BREAK are disabled. If 
the :bve is True (i.e., non-zero result), CTRL C/BREAK are enabled. 
If the :bve is False (i.e., zero result), CTRL C and BREAK are 
disabled. The SJ System Variable contains a status bit that is set 
whenever a CTRL C or BREAK is issued. This bit is reset whenever. an 
Auwws0:bve command is executed. 


In Direct Mode, an ASSIGN makes the specified device "current" only 
for commands executed on the remainder of the line. When all commands 
are executed, SI is automatically reassigned to the Principal Device. 
The assigned device is, however, still "owned". 
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Examples: 


1. 1.2 A 12 


2. 3,85 A 2,3,55:5008 


3. >A @3:1=2 


4. >F T=at:1:100 A 2 R TMP A 3 T TMP 


5. >S A=S"TEST” A 3 
ora 
TEST 


> 


6. >A 46,582512 Ww 


7. 7.65 A 59:216:2488 T X,! 


8. 4-3 A 4:8 T "HELLO"s! A 4:1 R REP:2@0 


9.. 3.7 A 47: "AVL" 


reserves device 12 and 
sets SI to 12 to make the 
device ‘current'. 


reserved devices 2, 33 


and 55% (which is a 
DECtape), makes 55 
‘current’ and sets SA to 


5000 to position the 
DECtape for the next I/O 
command. 


disables terminal 
interrupts of currently 
owned terminals and makes 
the principal I/O device 
‘current’. 


reads 100 lines, one ata 
time, from device #2, and 
outputs them to device 
#3. 


outputs the string 'TEST' 
to the princival 1/6 
device, since all 
commands did not reside 
on the same line. Device 


3 is still owned, 
however. 

reserves device 46 to 
View core, and reserves 
DECtapde unit 3 


positioning the tape at 
the head of the second 
tape block (512 bytes per 
block): makes the 
DECtape device "current" 
and writes the contents 
Of the program buffer 
onto the DECtape. 


assigns the first }§ (of 
four) Sequential Disk 
Processor and types’ the 
contents of X starting at 
byte 210 of block 2400 on 
RK11 unit 0, followed by 
a carriage-return, line 
feed. 


assume device 4 is a CPU 
device; send the text 
"HELLO" to the CPU in 
terminal state, Switch to 
message state and wait 20 
seconds for a reply. 


reserves Magtape drive 0 
and specifies the ANSII 
standard "D" format. 


10. 


2.65 A 47:"EUF" 


:80:240 
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reserves Magtape drive 0 
and specifies unlabeled 
EBCDIC 80-character fixed 
length records and 240 
byte blocks (3. records 
ver block). 
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3.3.2 BREAK Command 


Mode: | Indirect 


Syntax: | RO, Ae 


Description: 


This command is used to stop a program at a specified point to assist 
debugging during program development. The prime purpose of the 
command is to permit the examination of program variables at various 
States in a program's operation. 


When performed, the “command interrupts execution of the program, 
reassigns SI to 0O (Principal I/O Device), and prints out a question 
mark (?) followed ao word "BREAK" and the Step number containing 
the BREAK command. Control returns to the user in Direct Mode. At 
this point the program is still considered to be running, but in a 
Suspended state. Any attempt to modify the program will cause an 
error. If modification is desired, type a CTRL C, make the 
modification, and restart the program from the beginnina. 


The GO command (Section 3.3.9) is used to continue program execution 
after a BREAK. However, the occurrence of any error, or typing CTRL C 
will cause the BREAK to be "lost", thereby preventing execution of a 
subsequent GO. 7 | 


Examples: 


1. 2.51 BXx<1B — | | a BREAK will occur only if xX 1s 
ae | less than 10 

2. 6.1 B- So an uncenditional BREAK will occur 

3. 3.15 S A=B A 2 Beg te - the remainder of the line is not 


executed after the BREAK until a 
subsequent GO is issued. 
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3.3.3 CALL Command 


Mode: Direct or Indirect 


Syntax: Call {:bve! ws pnam {rspn} eae & 
Description: 


The CALL command initiates execution of a program residing in either 
the user's Program Directory or the System Library. Program execution 
begins where specified or at the lowest non-zero Part. 


When the program that was called is finished executing (i.e., no more 
Steps to do or a QUIT statement encountered), the original calling 
program is read back into the partition and re-entered at the point 
immediately following the invoking CALL command. 


NOTE 


The calling program must be FILEd 
(Section 3.3.7) or MUMPS will be unable 
to return to it after the CALLed program 
has terminated. This results in a NOPGM 
error message. 


When a program is called, all the local variables in the partition are 
preserved and available to it. The local variables remain unchanged 
except for changes which the called program may make. Execution of 
the program begins at the first non-zero Part unless a Part or Step 
number was specified by the optional ':spn'. The CALL command takes 
an average of two disk access times, one to bring in the called 
program and one to return to the calling program. CALL effectively 
increases the size of a program that can run in a given partition, but 
trades on execution time to do it. 


Each program named in the CALL command is loaded and executed one at a 
time, in the order of appearance in the CALL command. 


Example: 
This command line points out the features of the CALL command: 
6°35 CALL A» SAM?2S50sABEt Ss 2T 
1. Calls program A and executes it. 
2. Calls program SAM and executes it, starting at Step 2.50. 
3. Calls program ABE and executes en starting at Part 5. 


4. Calls the Time Subroutine $%$T and executes it. 
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DO 


3.3.4 DO Command 


Mode: Direct or Indirect 
Syntax: Do {rbve} ww SPN {:bve} 


Description: 


The DO command initiates execution of the specified argument. When in 
Direct Mode, the DO command provides the only means for initiating 
execution of command strings currently held within the user's 
partition. 


An argument may be: 
1. a Step number 
2. a Part number 
3. an svl that contains either 1. or 2. above. 


Tf control returns to the next DO command, the argument is in the mode 
in which the command was issued. In particular, if there is no other 
DO command argument and the DO command was issued in Direct Mode, the 
next command on the line is executed. Control ultimately returns to 
Direct Mode. If there is no other DO command argument, and the DO 
command was issued from Indirect Mode, control returns to the command 
following the DO. If no command follows the DO, control returns’ to 
the next (numerically greater) Step in that part (or back to the FOR 
command, if the DO was invoked in the range of a FOR). If there is no 
numerically greater Step in that Part, the program is terminated, and 
either control returns to Direct Mode, if the terminal user was logged 
in with a Programmer Access Code (PAC), or the terminal session is 
ended if the user was logged in simply to run the program. ' 


Examples: 
J 1.58 IF A=BI(C>D) DO 4 
2. 3.68 FOR X=1:25:245 DO 3.12,5,10.8) 
3. 108.01 FOR K=2,3 DO 6:'C(A=B),3.24 
Transfer out of the range of a DO using the GOTO command is legitimate 


and effectively alters the range of the DO to include all Steps and 
Parts specified by the GOTO. 


1. See the QUIT command, Section 3%3%19;,. fOr a discussion of the 
logical levels of program execution. 
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3.3.5 ELSE Command 


Mode: Indirect 
Syntax: ElSegwynext command 


Description: 


The command provides a means for testing the Boolean sense of the last 
IF command executed (Paragraph 3.3.13). When the sense of the last IF 
is False (0), commands following the ELSE on the same line will be 
executed. Otherwise, control will pass to the next program Step. 


Note that the use of the ELSE command (like the IF command with no 
argument), is different from the classical use of this command in 
other high level languages. Instead, its action is completely 
dependent on the Boolean truth value established by the execution of 
the last IF command and in no way related to its position with respect 
to other IF commands. 


Example: 


3626 I AGE>19 T “THANKS,! D 50 E T "NO ENTRY",! @ 
3.28 E T “NO GOOD",! Q 

3.29 T “DONE",! 

58.10 1 $DCTAGECAGE)) S TCAGE) =TC AGE) +1 Q 


In this example, if the condition in 3.26 is True, Part 50 is 
executed. Otherwise, the message "NO GOOD" is output. In Part 50, 
another IF condition is tested. Regardless of the outcome, control 
returns to the ELSE command in 3.26. If the Part 50 condition was 
False, the message "NO ENTRY" is output. If the condition is True, 
control passes to the ELSE in 3.28 which, in turn, passes control to 
3.29 causing the message "DONE" to be output. 


NOTE 


An attempt to use ELSE from Direct Mode 
is interpreted as ERASE since only the 
first letter of a command is 
interpreted. 
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3.3.6 ERASE Command 


Mode: Direct 


Lispa frspn} ,...|} 


syntax: Erase :bvel { 


Description: 


This command will delete an individual Step or Part, a range of Steps 
Or Parts, or an entire program in the user's partition. Arguments 
must either be legal Step or Part numbers or be number’ value 
expressions (nve) which result in legal spn. The optional second spn 
is used to specify a range (inclusive). An ERASE with no arguments 
(terminated simply by EOM or two spaces if other commands exit on the 
line) deletes the entire program. | 


Examples: 


1. >E 2.01 | , erase Step 2.01 

2. >ERASE 2.01:4.10 erase Step 2.01 through Step 4.10 

3. >E_4 erase Part 4 

4, >E 7 — erase entire program 

on >E LAD 1 — erase entire program, load program A_ and 


start it at Part l. 
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3.3.7 FILE Command 


Mode: Direct or Indirect 
Syntax: File {tbvefus{pnank... 
Description: 


The FILE command stores (files) the program steps currently residing 
in the user's partition on the disk and enters the program name (pnam) 
in the program directory associated with his UCI. If the FILE command 
does not have an argument, the current program name is assumed. 


After a program has been filed, it still remains within the program 
buffer. The user can continue to run it, modify it, and refile it. 
Every time a FILE command is issued under the same program name, _ the 
program steps currently present in the program buffer completely 
replace the previous program filed on disk. 


Example: 


>F TST 


Filed programs are deleted by filing a dummy program of zero length 
with the same name as the program to be deleted. This is accomplished 
by erasing the contents of the program buffer and subsequently filing 
that empty buffer under the program name to be deleted. | 


Examples: 


1. >E F ASL Deletes program A9L 
2. >E F SAM,ABE,A Deletes programs SAM, ABE and A 
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3.3.8 FOR Command 


Mode: Direct or Indirect 


s . WHILE 
syntax ° For, ,lvar= ave | ve inve, j aale } ave, NVC oONTIL Ldvef wynext command 


Index Variable 


where: lvar 


Initial value of lvar 
Value by which lvar is incremented 
Limit value of lvar 


where: nve, 
nve > 
nve 3 


Description: 


The FOR command produces efficient looping (iteration) by repeating 
commands residing on the same line for a specific set of variable 
values. In operation, the local variable (lvar) is set to the value 
specified by the first argument (nve,) and the commands on the 
remainder of the line are executed. The process is repeated for each 
new value (if any) of the first argument then the second, third, etc., 
until the lvar has been set to all values in the argument list. 


The WHILE and UNITL clauses can be used to test the status of logical 
conditions external to the FOR loop. Only one of these clauses can be 
used at a time and must be the last argument. 

Iteration is terminated in one of several ways: 


l. The argument list becomes exhausted 


2. A QUIT or GOTO command is encountered (Sections 3.3.20 and 
3.3.10) 


Upon termination, the index variable contains the last value assigned 
prior to termination. 


The arguments used (nvei, nveo, and nve3) may be assigned any 
value in the legal range of MUMPS numbers (see Section 1.4.1) 
including negative values. However, if the increment value (nve) 


is given a value of zero, an interminable looping condition will occur 
unless either the "WHILE/UNTIL" syntax is being used or a QUIT or GOTO 
is executed. 


There are two distinct forms for FOR command arguments which can _ be 
used either separately or together, as required. The first is the 
list format which excludes the optional nve's (nveo:nve3). With 
this format, each argument represents one specific value to which lvar 
is assigned. 
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Thus: 

FORwulvar=nve,nve,nve,... 
The second form is the range format in which the optional nve's 
(nve, :nve, ) are used. Each argument may represent a range of 
values. 
Thus: 

FOR, ,lvar=nve,:nveyg:nve3,nve _:nve _:nve__,... 
ia 2a 3a 

Both forms can also be intermixed: 


FOR Var=nve) ,nve nve snve»os:nve Bo 
OR,_,l lv 1a? 1 2 37 


b 


NOTE 
The indirection syntax operator (3.1) 
may not be used with arguments of a FOR 
command (e.g., 'Fyey«') causes a SYNTX 
error. 
Examples: 
1. List Format 
FOR X=1,4,1@ TYPE "X",X 


The loop will be repeated three times with X taking on the values 1,4, 
and 10. 


2. Range Format 


FOR Xzl21210 TYPE "X",X 


The loop will be repeated 10 times with X starting at 1 and increasing 
by 1 each time until it is equal to 10. 


FOR Xz=ls:1 WHILE Z>X TYPE "X",X 
This loop will be repeated until X becomes equal to or larger than Z. 
3. Range and List Formats 

FOR 1=5,8,33:6:57 TYPE I+(1/3),! 
In this case, I will take the values 5, 8, 33, 39, 45, 51, and 57. 


4. Special Cases 


FOR I=Azl:Y DO 3 if A initially greater than Y part 3 is 
never done 

FOR I=zle:-l:-2 DO 1.@5 step 1.05 is 'done' four times (for I=l, 0, 
-l and -?7) 

FOR I=lsAs1@ D 3.21 if A=0, an interminable loop on step 3.21 


is initiated. 
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3.3.9 GO Command 


Mode: Direct 
Syntax: Go {zbve} 


Description: 


The GO command is used to restart a MUMPS program which has been 
interrupted by the BREAK command (Section 3.3.2). This command can 
Only be used after a BREAK has been executed and while it is still in 
effect. This means that GO cannot be successfully executed after a 
CTRL C has been typed or after the occurrence of any MUMPS error. 
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3.3.10 GOTO Command 


Mode: Indirect 
Syntax: GOTO { :bve} ww Spn rbvel wee 


Description: 


This command permits transfer of control from the current Step 
sequence to the specified Part or Step number. Once the change in 
control is effected, program execution progresses in the normal 
ascending Part/Step number sequence. GOTO can also be _ used to 
prematurely exit from a FOR command loop. However, GOTO cancels all 
previous FOR commands up to the last DO or CALL, and execution 
proceeds from that DO or CALL (refer to Section 3.3.4). 


The argument can be either an actual Step or Part number or  numexic 
valued expression (nve) which evaluates to a legal Step or Purt 
number. Each argument in the list can be modified by an _ optional 
Boolean valued expression. It is reasonable to have multiple 
arguments only if they are modified using :bve's; otherwise the first 
argument would be the only one considered. 


Example: 


1.58 G 2.1:X<10,3.1:X>18,4.1 Control is transferred to Step 
2.1 if X is less than 10; to 3.1 
if X is greater than 10; and _ to 
4.1 in all other cases. 
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3.3.11 HALT Command 


Mode: Direct or Indirect 
Syntax: Halt {rbve} Reed een 


Description: 


This command terminates a MUMPS job and causes terminal sign-off. 


NOTE 


The difference between HALT and HANG is 
that HALT takes no arguments (:bve is 
not considered to be an argument). 


Examples: 
Direct Mode: 


>H 


Indirect Mode: 
3.51 I A>B H In both of these examples, HALT is executed if 


is greater than B. 
18,02 H:A>B 


3-22 


COMMANDS 


HANG 


3.3.12 HANG Command 


Mode: Direct or Indirect 
syntax: Hang {rbvel ws nve {rbve} pees 


Description: 


This command suspends program execution for a specified time interval. 
The time interval (nve) is specified in seconds and must be a positive 
MUMPS number. The number is evaluated aS an integer (i.e., the 
Gecimal point is ignored). If the nve equals zero, the remainder of 
the program's time slice (time sharing interval) is given up. When 
the specified time has elapsed, program execution resumes at the 
command following HANG. The maximum value which may be specified by 
nve is 65,535. If nve evaluates to a larger value, the maximum value 
1s used and no error is generated. 


This facility is especially useful in applications where the 
programmer periodically wants to check the status of a variable and 
take action when the variable has changed. 


Example: 
1.41 I $T<X H 300 G $L If the number of seconds since midnight 
(ST) ais less than xX, Suspend program 
execution for 5 minutes and then check 
1.21 C ZDL ST again; otherwise, call program 3DL. 
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3.3.13 IF Command 


Mode: Direct or Indirect 


‘ 


Syntax: IP is DVG@y sss tes next command 
| | 


Description: 


This command is used to effect a change in a program's operation based 
on the validity of one or more Boolean Valued Expressions. Each bve 
in the argument list is evaluated. If all expressions are True 
(non-zero), command processing continues with the next command on the 
line. If any expression is False (zero), command processing for the 
remainder of the line is discontinued and the next Step is executed. 
IF may also be used without arguments, in which case the condition to 
be tested is the sense of last executed IF statement. The ELSE 
command is used to test the logical reverse of an IF (see _ Section 
34330) 


Example: 


' 


2.08 IF A=BICC=>D) ,NAM="JACK™ DQ 3 
6.03 IF GOTO 14,36 


If A equals B, or C is greater than or equal to D, and NAME equals the 
string JACK, all the commands in Part 3 are executed. Assuming this 
is the case, (True) and there are no other intervening IF statements 
which result ina False condition, the execution of 6.03 will result 
in control passing to step 14.36. 


When the Indirection Syntax is used, it: must be the last argument. 
Further, the variable referenced by the indirection (i.e., « variable) 
may contain commands’ as well as additional arguments to the IF 
Command. ns . 


Example: 


Where: a, b and c are arguments. 
X, yY and Z are commands — 


Teel: S tet D= "A, Dy Cou X eYez" 
162. The eo | 
1.3 | 


As with IF without indirection, each argument iS processed until a 
False result is obtained or a command is reached. Once a False 
argument is reached, the remainder of the line is skipped and 
processing continues on the next line. When an indirect reference is 


1. Excluding the FOR Command 
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used, the commands which may follow on the same line are no _ longer 
dependent upon the logical result of the IF. 


Example: 


Where: a,b,c, and d are arguments, and 
x and y are commands 


3.1 SET wuD="c,duuy" 
3.2 IFuua,b,+Diux 


If a and b are True, command x will always be executed, regardless’ of 
the truth value of arguments c and d, as long as y is not a GOTO or 
HALT command. 


If nested indirection is used, the basic process remains the same. 
Suppose there are three levels of nesting (three indirect references). 
If all arguments up to the first indirect reference are True, the 
commands following on that line will be executed after the truth value 
of lower levels has been determined, and any lower level commands have 
been executed. 


If all arguments up to the second indirect reference are True, 
commands following on that line will be executed after the truth value 
of lower levels has been determined, and any lower level commands have 
been executed. In general if all arguments on all levels are True, 
all commands on all levels will be executed, beginning at the deepest 
level. 


EXCEPTION 


Any GOTO or HALT Command will prevent 
execution of commands at all levels 
above it. 


If one of the arguments contained in the second indirect reference 
happens to be False, the rest of the arguments on that line as well as 
the commands and arguments specified by the third indirect reference 
will not be processed. Rather, any commands following the second 
indirect reference will be executed followed by the first indirect 
reference. 


Example: 


Where: b, e, h, k and 1 are arguments 
c, £f, i, m and n are commands (other than GOTO) 


6. LenS emA="bewc" 

6. 2eemtSemD="e ,+ Anuf" 

6 2 3 tet S totG="h,+Dewi" 
6.4esTFosk,1,+Guismeun 


If k and 1 are True, m and n will always be executed. If h is True, i 
will always be executed. If e is not True, the commands and arguments 
in A will not be reached and f will not be executed. If k, 1, h, e 
and b are all True, c, f, i, m and n will be executed in that order. 


Examples: 


Le. Ll. leuSeuP="A>BeuSewA=B" 
Ls Jet Row" A=" Pear ! v "B=" aoe Sel Pe + Po TowwB 
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In this example, the variable P is set to a string which is 
to be used as an argument to the IF in Step 1.2. Step 1.2 
requests values for A and B; then the IF is evaluated. If A 
is greater than B, A is SET to the value of B. The value of 
B is typed regardless of the logical outcome. | 


>2.1leuReo"A=",A,!,"B=",B, ty yl Fy+ Poul oy os TeB 


This example is a variation of Step 1.2 in the example above, 
in which a second IF has been added to permit the typing of B 
only if A is greater than B. 


This example is taken from a MUMPS System Program. The 
variables RK, RF and RP (i.e., RK0O3, RF1l1l and RP1l) have been 
previously set to the number of disk drives of each type in 
the system, or zero if there are none. | 


Step 1.1 is a string which is to be used in a_e subsequent 
indirect reference by means of the SSTEP Function. The 
string could not be contained in a variable since the string 
itself contains a literal which must be delimited by 
quotation marks. 


Step 2.2 requests the name of the System Disk placing the 
response in SD. 


Step 2.3 contains an IF command with two arguments (a) and 
(ob), and a GOTO (c). 


1. dou+SDeoE eT ws"THERE ARE NO",SD,"DISKS IN THE SYSTEM", ,G 


2.2.aRVL,"TYPE THE NAME OF THE SYSTEM DISK",!,SD | 

2. 3uul Fou (SD="RK") ! (SD="RF")! (SD="RP") ,«SS (1.1). GOTO u4 
(a) (b) (c) 

2.4 esTes!,"RK, RF OR RP", !epGau2. 2 


Analysis: 


SD contains the response obtained in Step 2.2. In 2.3 SD is 
tested to determine whether it contains the string RK, RF, or 
RP. If it is none of these, control passes to Step 2.4 and 
the indirect reference is never executed. 


If the response iS correct, the indirect reference is 
reached. It ensures that the specified disks exist. The 
first element in 1.1 is another indirect reference which 
permits testing of the contents of SD. This results in a 
Boolean evaluation of the contents of one of the variables: 
RK, RP or RF, to see if it iS non-zero (i.e., some disks of 
the desired type exist). Since there are no commands in SD, 
commands following the second indirect reference are 
executed. The ELSE Command tests the outcome of the IF and 
causes the message beginning "THERE ARE..." to be output if 
False condition exists. 


If a True condition results, control returns to Step 2.3 from 
the indirect commands in 1.1 and the 'Guu4' is executed. 


, a | e 
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3.3.14 KILL Command 


Mode: Direct or Indirect 


Syntax: Kill {ibve} { 


Description: 


KILL 


tuvariable,...|} 
a a | 


The KILL command is used to delete both local and global variables. 


When used without arguments, all 


locally defined variables are 


deleted. Examples of this syntax are as follows: 


12.58 K S A=5@ 


>K 


= all local variables are deleted 


When KILL is used on a subscripted variable, it is possible to delete 
any one of the array variables by its full name or all the variabies 
by Simply stating the array name. Simple variables need only be 


named. 
Examples: 


dite 3.81 K ABC(3) 


Ze 6.58 K tDEFC5), TDEF (6), tDEF(7) 


Bs 1.98 K ABC 


Local array element 3 is 
deleted from the array ABC. 


Global array elements 5, 6 and 
7 are deleted from the array 
DEF. 


Deletes all elements in the 
array ABC. 


The local variable Xx is 
deleted. 


If both a simple variable and a local array are defined under the 
Same name, a KILL referencing that name deletes the array as well 


as the simple variable. 


The KILL command, when applied to global variables, can kill all 
the data in a global or "prune" the global array at any specified 


node. 
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5. >K “ABC 


BEFORE COMMAND AFTER COMMAND 
TORARERG UEeRt THE ENTIRE GLOBAL ARRAY, 


AS WELL AS ITS DIRECTORY 
ENTRY IS DELETED 


(4,1, 1) tt, 12) ({,2,1) eye) 


6. >K “ABC(1,2) 


BEFORE COMMAND AFTER COMMAND 


DIRECTORY ENTRY 
FOR ARRAY ABC" 


(SAME AS ABOVE) 
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7. >K ~ ABC (1) 


BEFORE COMMAND AFTER COMMAND 


DIRECTOR ENTRY DIRECTORY ENTRY 
FOR ARRAY "ABC" FOR ARRAY "ABC" 


3729 
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3.3.15 LOAD Command 


Mode: Direct 


Syntax: Load {rbvel ww pnam 
: heed bl 


Description: 


This command loads a program from the disk into the user's partition. 
If a program name (pnam) is specified, the user's Program Directory is 
searched, his program buffer is erased, and the program is loaded. If 
no argument is given, loading occurs from the device specified in the 
Previous ASSIGN command on the same line (i.e., the current value of 
the $I System Variable). In this case, the program buffer is not 
erased and the loaded program is merged with the contents of the 
program buffer. | Steps in the loaded program take precedence over 
Steps in the program buffer having the same number. In either case, 
all local variables in the partition are preserved. 


Examples: 


1. >LOAD SAM loads program SAM from user's program library 
2. A 2L_ FILE SAM loads program from device #2 (paper-tape 


reader), then files it under the name SAM. 
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3.3.16 LOCK Command 
Mode: Direct or Indirect 


wot IGVaL 
Syntax: LOCK ybve } {:nve } 
wus |(GvVar; ,-GVaro,... gvar,,) 


Description: 


The LOCK command provides ownership of global variables on a= node 
level. After execution of the LOCK command, the LOCKed node, all 
global variables in the tree structure directly below the LOCKed node 
or global variables above it in a direct path to the top of the global 
are unavailable for locking by other users. Use of the LOCK command 
is not mandatory; protection is provided only through application 
programming convention, and only when all users also use the LOCK 
command. The LOCK command does not require any use of the disc. 


Example: 


Given the global fA below, 
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aan yaaanl ) a2at 
(Lgey sy ks) é (1,2,3,4) = 


After execution of LOCKtA(1,2,3), the following nodes are unavailable 
for LOCKing while node+A(1,2,3) is locked: 


4A (1,2,3,4) 
AEC Lg Leo k) 
4A (192) 

tA (1) 

4A 


The following nodes of tA would be available for LOCKing by other 
users while node +#+A(1,2,3) is LOCKed: 


AA (2) 

4A (2,1) 
4A (1,1) 
4A (1,2,1) 
4A (1,2,4) 


The execution of a LOCK command unlocks all global variables that were 
previously LOCKed by the user. 


For example, after this series of commands are executed: 


1.20 LOCK tA(1,2) 
1.30 LOCK (#A(2,1),+tA(1,1),+tA(1,2,4)) 
1.40 LOCK (#fA(1,1),#A(1,2,3,4)) 


only global variables #A(1,1) and tA(1,2,3,4) would be LOCKed. 


‘When using the multiple argument form of the LOCK command care must be 
taken to enclose multiple arguments in parentheses. If there are no 
parentheses the command will be interpreted as multiple LOCK 
directives rather than as one LOCK directive with multiple arguments. 
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For example, the following command: 
1.10 LOCK tA(1,2,3) ,tB(4) ,#tABC(3,1) 


would be the same as this sequence of commands: 


1.10 LOCK +tA(1,2,3) locks tA(1,2,3) | 
1.15 LOCK +tB(4) unlocks +A(1,2,3), locks +#B(4) 
1.20 LOCK tABC (3,1) unlocks +B(4), locks #ABC (3,1) 


and only global variable tABC(3,1) will be locked after execution of 
the commands. 


If a global variable is unavailable (LOCKed by someone else) when a 
LOCK request is made, the job will hang without any LOCKed nodes until 
the requested node(s) is free. If multiple arguments were used in the 
request, MUMPS will not LOCK any of the global variables until they 
are all available to be LOCKed. 


The optional parameter (:nve) permits the MUMPS programmer to specify 
how long the system can wait to be able to LOCK the specified global 
variable(s) if they are unavailable when the request is initiated. 
The :nve must be a positive MUMPS integer, the decimal fraction is 
ignored. If MUMPS is unable to LOCK all the specified global 
variables before the specified time interval has elapsed, none of the 
globals will be LOCKed and control will be returned to the user. 


The MUMPS programmer may check the result of a timed LOCK by 
inspecting bit 4 of the S$JOB system variable. Bit 4 will be set to 
one if MUMPS was unable to perform the LOCK. 


Example of a timed LOCK: 


LOCK (4A(1,2),%4B(3)):5 
If MUMPS is unable to LOCK both 4A(1,2) and #B(3) in a five second 
time frame, then neither global variable will be LOCKed, bit 4 of S$JOB 
Will be set to one, and control will be returned to the program. If 
the LOCK was successful then both #A(1,2) and *B(3) are LOCKed and bit 
4 of the SJOB will be set to zero. 


The following isSsues are important aspects of the LOCK command. 


1. Use of LOCK is not required; protection is only through 
application programming convention. | 


2. LOCK does not use the disc. Furthermore, the LOCKed nodes do 
not have to correspond to existing nodes on the disc. 


3. When performing a LOCK, all nodes for that user are first 
automatically UNLOCKed. 


4. All arguments of the LOCK command must be full global 
references; naked expressions are not allowed. 


5. The gvar expressions do not affect the naked global level. 


6. A LOCK only pertains to the user's UCI. LOCKS under other 
UIC's are not affected. 
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3.3.17 MODIFY Command 


| Mode: Direct or Indirect 


Syntax: Modify {:bvelay spn:x Sve1X Sve? 


spn: sve 
Description: 


The MODIFY command provides program editing capabilities by altering 
the contents of a Step. The command causes a search within the 
specified Step for sve, and if found, replaces 1c with Ssve>. 
Argument delimiters, specified by x, may be any character. The only 
restriction is that the character used to delimit sve, and sve, 
should not be included in either expression. 


NOTE 
Step numbers cannot be changed with the 


MODIFY command. 


If sve, is null (i.e., xxsveox), sve, will be inserted at the 


beginning of the Step command line. If sve, is null (i.e., 
xSVe, xX), SVe; will be deleted from the Step. The WRITE command 
is used to display the altered Step. ss 
Example: | | 

1.81 R"NAME”,NAM,I | _ old line ; 

>M 1.81:/"/"YOUR S . modify the line 

>W_ | write it out 


1.01 R “YOUR NAME", NAM,” neo. Tne 


When MODIFY is used in Indirect Mode, the spn of the Step containing 
the MODIFY command must be less than the spn specified in the command. 
If it is not, a PROTect error is generated. Further, MODIFY cannot be 
used to increase the size of a program. 
The second version of the MODIFY command is used for step creation. 
This version creates the step specified by spn and uses the value of 
sve for the step's contents. The spn must be previously undefined. 
Example: 

M 2.12:".S. ,A=B" 
creates the step 


7G BMA TERY No 
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3.3.18 OVERLAY Command 


Mode: Indirect 


Syntax: Overlay {rbvel ws PNam \:spn} 


Description: 


This command loads and starts programs residing in the user's Program 
Directory as well as the System Library. Program execution begins at 
the lowest non-zero Part unless a Step or Part number (spn) is 
specified. When spn is used, execution starts where specified. 


NOTE 


If a non-existent :spn is specified, a 
NOPGM error is generated. The name of 
the program and the next: higher’ spn 
available is printed out following the 
NOPGM message. 


Local variables remain unchanged unless the overlaying program changes 
them. 


When the currently controlling program control command is a DO and an 
OVERLAY is executed, that DO is effectively converted into a CALL for 
the remainder of its duration. That is, execution of a QUIT in the 
program which is OVERLAYed would result in a return to the DO in the 
program which contained the OVERLAY command. 


OVERLAY is similar to the GOTO command except that the program flow is 
transferred to another program. The program flow does not return to 
the program containing the OVERLAY command unless the OVERLAY was 
executed when a DO was the currently controlling program control 
command. 


The OVERLAY command takes an average of one disk access to load _ the 
specified program and is therefore faster than the CALL command which 
takes two disk accesses. This should be taken into account’ when 
designing a system of application programs. 


Example: 


7.61 OVERLAY SAM:!.52 brings program SAM into memory and 
starts it at Step 1.52. | 


When uSing OVERLAY, it is more efficient to execute the command at a 
point where the current program segment becomes ‘I/O bound'. This 
permits the time taken by the overlaying process to be 'submerged' by 
the I/O processing time. | 
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Example: 


Assume that a program consisting of two overlays called AB and BA 
requires input from a terminal at some point in its operation. This 
can be accomplished as shown in either A or B (below). However, the 
time taken to type out "PATIENT ID", as shown in B, is also used to 
submerge the time needed to effect the overlay of BS as well. 


Overlay AB | 


9.18 READ !,"PATIENT ID--",ID 
9.28 OVERLAY BA 


Overlay BA 


(process data input by AB) 


Overlay ABI oe om 


9-10 TYPE !”°PATIENT ID--" 0 BAZ 


Overlay BA2 
1.@1 READ ID 


(process data input by BA2) 
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3.3.19 PRINT Command 


Mode: Direct or Indirect 
nve 

Syntax: Print {:bve} literal patea 
format 


Description: 


This command iS used primarily to output device dependent control 
characters to the currently assigned I/O device (SI System Variable). 
Device dependent data is output using nve to represent a decimal 
integer value whose 7 low-order bits are accepted as ASCII. The 
fractional portion of the nve (if any) is ignored. Thus, the 
programmer can take advantage of the control functions of a particular 
device. 


Example: 

1.85 PRINT 7,13,12 will (on a teleprinter) ring the bell, 
return the carriage without a LINE FEED, 
and FORM Feed. 

7.23 P 29,31 will, on a VTO5, move the cursor to the 


upper left corner of the screen and 
clear the screen. 


Arguments to the PRINT command may also be MUMPS-11 format control 
characters (#,?nve,!) or literals. For example, the command 


6.58 PRINT #,7,720,"YOU WIN” causes a teleprinter to: 
perform a FORM Feed, ring the 
bell, tabulate 20 spaces from 
the left margin, and type: 
YOU WIN 


Special nve arguments to the PRINT command allow the programmer’ to 
change system protection parameters in the SJ System Variable and to 
effect control functions for magnetic tape I/O operations. System 
protection arguments are: 


1. Peuwl024 enables Library Program and Global update. 

2. Pew2048 disables Library Program and Global 
update.!: 

3. Pew256 enables memory or disk write with VIEW 
command. 

4. Peuw512 disables memory or disk write with VIEW 
command. ' 


1. System default condition. 
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If an error occurs (SYNTX, PROT, etc.) after a Pi,41l024 or a Py 4256 is 
issued, these parameters are reset to the system default condition 
(P,,2048 and Py,512). The MUMPS Programmer's Guide provides more 
details on the use of the $J System Variable. 


Special arguments to control magnetic tapes are also described in the 


MUMPS-11 Programmer's Guide. 
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3.3.20 QUIT Command 


Mode: Direct or Indirect 
Syntax: Quit {:bve} 


Description: 


The QUIT command terminates a logical process, including the execution 
of a Step, Part or program. The command is often used to prematurely 
terminate operations which are executed within the range of the DO, 
FOR, and CALL commands. 


To understand the QUIT command, it is useful to think of a program's 
execution aS occurring at different logical levels. The first or 
lowest level is simply operation in Indirect Mode itself. Higher 
levels are attained by the use of the DO, FOR, and CALL commands and 
their subsequent nesting. Each time one of those commands is 
encountered within its own range or that of another, the level is 
raised by one. The normal termination of these commands lowers’ the 
level by one. When QUIT is executed, the current level is also. 
lowered by one and the associated DO, FOR, or CALL command is 
terminated. When the terminal user is logged-in to the system with a 
Programming Access Code (PAC), a QUIT at the lowest level switches 
control to Direct Mode. When logged-in simply to run a program (i.e., 
UCI:pnam.a), QUIT at the lowest level ends the session at -the 
terminal. 


Examples: 


1. 1.01 FOR IT=121:100 S A=A+I QsA>X 


1.9 @eee 


In this program if A becomes greater than xX, the QUIT 
prematurely terminates the FOR loop and control passes to 
Step 1.02. Otherwise, the FOR loop terminates normally after 
100 iterations. 


2. 8.19 FOR X=3:35:23380 D9 I X+P=A Q 


; a 2nd level ie (a 3rd level 


8.35 
9,18 I PR=<1.2 Q 
4th level 4 3 return to 2nd level 


osteo 
9.12 CALL AQ 


In this program, the level is raised by one when the FOR loop 
1s entered. When the "Day?" in 8.1 is executed, the level is 
raised to 3. When PR=<]1.2, the QUIT returns to the 2nd level 
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and the rest of the FOR loop is performed. If PR is not 
=<1,2, program A is called, raising the level to 4. When 
program A completes its operation or a QUIT is executed from 
within it, control returns to the QUIT command following the 
CALL, which returns control to the 2nd level. When X+P=A, 
QUIT restores level 1 and Step 8.3 is executed. 


COMMANDS 


READ 


3.3.21 READ Command 


Mode: Direct or Indirect 
lvar Inve} 

Syntax: Read |:bve} haan literal pg ae 
format 


Description: 


This command is used to input one or more lines of characters’ into 
Specified local variables (lvar) from the currently ASSIGNed input 
device (value of SI System Variable). Literals and format control 
characters (Section 3.2) can also be output to the device, provided 
that it is capable of accepting output (a NODEV error results if it is 
not). 


Each string input is assigned to the specified lvar. Note that all 
data input is string-valued so the MUMPS programmer wishing numeric 
data must provide the necessary checks on input’ strings. (For 
example, see Section 2.4.4 on pattern verification.) 


The optional argument (:nve) permits timed reading by specifying the 
number of seconds for which the command is to be effective. Each 
argument in the command can use this’ feature. It is particularly 
beneficial when an applications program must deal with terminals which 
are infrequently attended or unattended. 


The snve must be a poSitive MUMPS integer; the decimal fraction is 
ignored. If no input is detected before the specified interval has 
elapsed, a null string is returned in the lvar, bit 4 of the $J System 
Variable is set, and the next command on the line is executed. If 
input occurs before the interval expires, the interval is repeated 
until one of the following conditions exists: 


1. No input has ocurred since the last interval (a null string 
is returned). 


2. A Carriage RETURN or ALT MODE is received. 


In the case of (a.), all accumulated characters up to time-out are 
discarded and a null string is returned; with (b.) however, all 
characters in the input line are returned. 

Examples: 


1. 1.32 READ 1,"NAME?",NAMCI),!,”AGE=",AGECI) 


In this example, the command requests two consecutive lines 
of input from the terminal. The lvar AGE(I) is assumed to be 
a one or two digit numeric character string, and the program 
must convert this if it is desired to store it aS numeric 
data. Automatic mode conversion will be employed when the 
lvar is used subsequently in the program, however, this does 
not affect the data mode of the data in AGE(I) unless it is 
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directly altered as in: S,,AGE (I) =AGE(I)+. (Refer to 
Section 2.3.3 for more information.) 


1.36 R “ANYONE THERE?”,!,RES220 I $J&.16 H 


In this example, the message "ANYONE THERE?" followed by a 
Carriage RETURN/LINE FEED sequence is output. If there is no 
response within 20 seconds or the operator took more than 20 
seconds to type a character of input, the program will halt. 


COMMANDS 


SET 


3.3.22 SET Command 


Mode: Direct or Indirect 
Syntax: Set { sbve} ws Variable=expression,... 


Description: 


The SET command assigns the result of an expression to aé_e specified 
variable. The variable can be simple, subscripted, or global. The 
variable is followed by an equal sign (=) which in turn is followed by 
any expression that conforms to the rules for forming expressions (see 
Chapter 2). The expression is evaluated and the variable is set to 
the result. 


The list of variables and associated expressions is evaluated and 
assigned from left to right. If a variable used in an expression is 
set by a previous argument, the value used is that most recently 
assigned. 


Example: 


1.10 2 

1.28 3, B=Ax2 B is SET to 6 

Automatic mode conversion is employed during expression evaluation. 
The ultimate mode of an expression - string or numeric (including 
Boolean values) - is determined by the type of the last operator in 
the expression. It may be a trailing operator. Legal trailing 
operators include: concatenation (@) to force a string valued result 
and addition (+) to force a numeric result. (See Section 2.4.7). 


WARNING 


Special care should be exercised to 
avoid omitting the equal sign (=) since 
this situation is not detected as an 
error. Instead, the command is 
interpreted to be a START command in 
which the variable name to the left of 
the missing equal sign is taken as_ the 
name of the program to be STARTed. If a 
program of that name exists, it is 
loaded and started; otherwise a NOPGM 
error results. 
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1.32 S A=B,DAT,D! 
fo missing '=' sign 


This Step is interpreted as: 


SET A = 3, then START a program called DAT at Part 1 


Example: 


2.5 S $£=20.5 


28.5 S ERR=$E,$E=30 


sets the SE System Variable so that all 
MUMPS errors (except GARB errors) will 
trap to Step 20.5 for analysis by the 
application. 


saves the contents of SE ( a value in 
the range 0 through -0.36 denoting a 
specific MUMPS error) and resets SE to 
trap to spn 30 in caSe any error occurs 
prior to completion of application error 
processing. 
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START 


3.3.23 START Command 


Mode: Direct or Indirect 
Syntax: Start { rove} iw ONaM {(nve)} {:spn} jee 


Description: 


This command permits a currently executing program to load and start 
one or more programs that run concurrently in separate partitions. 
The optional nve specifies the partition size in integer multiples of 
128 words. The optional :spn specifies the Step or Part number at 
which execution iS to begin; otherwise, execution begins at the 
lowest non-zero Part. 


NOTE 


If a non-existent :spn is specified, a 
NOPGM error is generated. The name of 
the program and the next higher’ spn 
available is printed out following the 
NOPGM message. 


Each STARTed program must ASSIGN all required I/O devices. 
Furthermore, STARTed programs share the Principal I/O Device of the 
Starting program. Before a STARTed program can use the Principal I/O 
Device, however, the starting program or any other STARTed program 
must UNASSIGN (Ugy40) the device. 


Error messages which result from a STARTed program are output to the 
Starting program's Principal I/O Device regardless of the current 
ownership of that device. However, if a STARTed program is to give up 
its partition, the Principal I/O Device must be available. 


Example: 

3,24 START ZDV,2LX:5,ACL22 loads and starts $%DV, %LX 
beginning at Part 5 and ACL 
beginning at Part 2, each ina 
separate partition. 

165 S tPI=3014 S RADCB)219-25 sets a global variable PI 


equal to 3.14 and _ starts a 
program RAD at Step 10.25 ina 
1K partition. Refer to the 
MUMPS Operator's Guide for 
details on partition sizes ane 
availability. 
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3.3.24 TYPE Command 


Mode: Direct or Indirect 
expression 
format 

Syntax: Type {rbvel 

Y YP 3 variable ae 
| ae 


Description: 


The TYPE command outputs data to the currently ASSIGNed device (SI 
System Variable). Arguments can be expressions or the format control 
characters (#,?nve or !) described in Section 3.2. If no arguments 
are specified, the current values of all local and System Variables 
are output. 7 


Examples: 


1.36 TYPE "VALUE=",A,! results in 'VALUE=contents of 
A followed by a Carriage 
RETURN, LINE FEED sequence. 


>TYPE | types out the contents of all 
local and system variables. 


2.98 TYPE #!,"A+BxC=" ,A+B*C types FORM Feed, Carriage 
RETURN, LINE FEED sequence, 
"A+B*C=results of atb*c.' 
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3.3.25 UNASSIGN Command 


Mode: Direct or Indirect 
Syntax: Unassign {zbvel ted NVE, oe 


Description: 


The UNASSIGN command releases the specified I/O device(s) and 
associated buffers from the ownership of the current job for use by. 
other programs (i.e., it reverses the effect of the ASSIGN command). 
At least one argument must be specified or a syntax error is 
generated. Arguments which reference nonexistent devices or devices 
not previously ASSIGNed are ignored. The nve is interpreted as an 
integer; decimal fractions are ignored. 


A program's Principal I/O Device (device on which terminal user 
logged-in) may also be UNASSIGNed to permit its use by other programs. 
The operating system automatically reassigns it when an error is 
detected or Direct Mode is entered. . 

Example: 


>U 1,353,638 Unassiagns devices 1,3 and 63. 
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3.3.26 UNLOCK Command 


Mode: Direct or Indirect 
Syntax: UNLOCK { sbve} Ms i 


Description: 


The UNLOCK command releases the global variable(s) from ownership of 
the current job for use by other programs (i.e., it reverses the 
effect of the LOCK command). All previously LOCKed global variable(s) 
will be UNLOCKed. | ; | 


An UNLOCK is automatically performed when a job is HALTed. 
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3.3.27 VIEW Command 


Mode: Direct or Indirect 
Syntax: View {:bve} ws NV} {rnve: } pees 


Description: 


This is a special purpose command permitting both reading and writing 
of disk storage blocks in the system's data base, as well as the 
writing of memory locations. The command aids in the creation of 
MUMPS application and system programs where the direct modification of 
disk or memory is required. It is assumed that the user of VIEW is 
familiar with the system's file structure and the memory-resident 
system tables described in the MUMPS-11 Programmer's Guide, 
particularly the system table (SYSTAB). Further, the use of VIEW is 
restricted by several levels of protection, Since its use by 
unqualified individuals could seriously degrade system operation. 


The function performed by VIEW depends upon the presence of the 
optional Nnveo. When nve2 is not specified (and device No. 63 is 
assigned), VIEW operation is directed to disk. The address of a_ disk 
block to be accessed and the logical disk number is specified by 
nve.. If nve; is positive, the specified disk block is read; if 
negative, the block is written. Only the integer part of the nve's 
are used by VIEW; fractions are ignored. 


NOTE 


When using VIEW to write to the disk, no 
other jobs should be running, including 


the "Garbage Collector".' The 
MUMPS-11 Operator's Guide. describes 
procedures for establishing this 


condition. 

When accessing disk, the following expression must be used for forming 
nve,: | | 
nve,; = TYP*2,097,152+(UNT*262,144) +BLK 

O for RK1l1 
where TYP(device type)= 1 for RF1l 

2 for RPll 

3 for RJPO4 

UNT (unit number) =m,0<m<7 


1. The Garbage Collector routine is described in the MUMPS-11 
Programmer's Guide. 
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a 4799 for RK1l1l 
-BLK(block address on unit)= n,0<n¢ 1023 for RF11 
79,999 for RP11 (RPO3) 
39,999 for RP11 (RPO2) 
170,543 for RJPO4 


When using VIEW to read or write disk blocks, input from and output to 
the disk is directed to a special buffer in memory called the VIEW 
Device Buffer. Each transfer by VIEW causes an entire disk block (256 
words) to be read or written from this buffer. The VIEW Device Buffer 
is accessed by the user via VIEW (to write memory) and the SVIEW 
Function (to read memory) .' The address of the VIEW Device Buffer is 
obtained from the System Table entry labelled "UTLBUF". The address 
of the System Table is contained in location 4410. Using SVIEW, the 
buffer address can be obtained as follows: 


Where: OFF = OFFSET TO 'UTLBUF' in System Table. 


1.28 S ADR=$V($V(44)+0FF) 


4 


il. Get address of System Table. 
2. Add OFFSET TO 'UTLBUF' to obtain the 'UTLBUF' address. 
3. Get the address of the 'VIEW' Device Buffer. 


When nve, is specified (and device No. 63 or No. 46 is assigned), 
VIEW operation is directed to memory. The address of the memory 
location is specified by nve;, and its contents by nve2. Since 
VIEW operates on word (as opposed to byte) addressing, if nve,; is 
odd, it is interpreted internally as an even number by subtracting 1. 
Both nve, and nve, must always be positive when addressing memory. 


NOTE 


The VIEW command allows access to 28K 
words of memory. For systems with more 
than 28K words of memory, references’ to 
address locations (nve,) 40960°-57342 
are interpreted as address locations 
0-16382 beginning at the base of the 
current partition. 


There are three levels of protection that control the use of VIEW: 


1. The user or program must "own" the use of VIEW by having 
ASSIGNed either device No. 63 for operations directed to 
either memory or disk, or device No. 46 for operations 
directed to memory only (Paragraph 3.3.1). 


l. Described in Section 4.2.16. 


2. This would vary as to how the system is built. 


Zs 


a6 


Examples: 


ese 


Lie 
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To read disk blocks either: 


Ae 


b. 


The user must be logged in with the System's UCI 
described in the MUMPS-11 Programmer's Guide, or 


the program must be a Library Program (i.e., % symbol 
must be the first character in the program's name). 


To write a memory or disk: 


ae 


D. 


Conditions 1 and 2 (above) must be met; and 


The Print command, P4256, must be issued. 


This program zeroes out the VIEW Device Buffer: 


1-31 A 46 S VBF=$VC$V(44)+0FF) 
1.02 F [=8:2:518 VIEW VBF+13:@ 


The 
one 
the 
has 


1.01 R 
1.95 A 
1.13 U 


following is part of a program that could be used to copy 

unit of an RKO3/RKO5 Disk Pack to another. N and M are 
physical device numbers (RKO, RK1, etc.). Each device 
4800 data blocks. | 


“INPUT RK UNIT:",N,!,”"OUTPUT RK UNIT:",M,! 
63 P 256 F 1218124820 V N*262144+1, -("*2621 4441) 
63 P 512 T “DONE",! | 
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3.3.28 WRITE Command 


Mode: Direct or Indirect 


= oe 


Syntax: Write {rbve | Remand 

This command is used to output MUMPS programs or individual Steps’ and 
Parts residing in the Program Buffer of the user's partition to the 
currently ASSIGNed I/O device ($I System Variable). WRITE essentially 
performs the opposite function of the LOAD command.! If no arguments 
are specified, the entire program (all Steps) is output. The optional 
Boolean expression (:bve) establishes conditional execution. 


Description: 


Spn, specifies individual Step or Part numbers, while :spn»> 
specifies a range of Steps or Parts between spnj and spn», 
inclusive. Both Parts and Steps can be intermixed in the same command 
Or its arguments. 


Examples: 


>A SW Write out all Steps on _ the 
Line Printer (device #3). 


1.56 W 4.2,1.13,637 Output Steps 4.20, 1.13 and 
Parts 6 and 7. 


10.04 W 7.1427,30,1.5522,03 Output Steps 7.14 through 7.30 
| and 1.55 through 2.03. 


1. LOAD also inputs programs from the user's Program Directory on 
disk. FILE must be used to save programs on disk. 
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3.2.29 XKILL Command 


Mode: Direct or Indirect 
Syntax: Xkill {rove | ang LVAL pe ee 


Description: 


The XKILL (eXclusSive KILL) command deletes all local variables and 
their associated arrays, except those specified in the argument list. 
This command is an extension to the more general KILL command. Note 
that subscripted variables are illegal arguments and cause a SYNTX 
error. 


Example: 


3.26 X A,B,C G 11.10 Kill all local variables except A, B and 
C then GOTO step 11.10. 


CHAPTER 4 


FUNCTIONS 


4.1 INTRODUCTION 


A function is a component of an expression that invokes an algorithm 
the result of which is an expression element. Each MUMPS function is 
ldentified by a unigue mnemonic, the first character of which is 
always the dollar sign (S$). There are two types of functions: 
numeric and string. Numeric functions return numeric values (nv), 
while string functions return string values (sv). The value returned 
is not named and can never be explicitly referenced. The returned 
value internally replaces the function designation and its arguments 
within the expression. 


4.1.1 Nesting of Functions 


MUMPS functions may be nested to the same extent that functions which 
produce numeric results may be nested within any other function. 
Functions which produce string valued results may NOT be nested. 
Furthermore, where the argument to any function is required to be a 
String value, it must be in the form of a string variable or literal 
(svl). 


4.1.2 Syntax Rules for MUMPS Functions 


l. Functions names may be abbreviated to the first character 
after the dollar sign (S$). 


2. Arguments are enclosed in parentheses and immediately follow 
the function name. 


3. Multiple arguments are separated by commas. 


Numeric 
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Table 4-1 


Summary of Functions 


SCreate (svl) 


lvar 


SDefine ( vee 


) 


SFind (svl1,svlo \:nve } ) 


gvar 


SHigh ( lvar (subscript) 


) 


SInteger (nve) 


$Length (svl) 


+ 
* 
/ 
> 
< 
SM (marg, = Marga... 
>= 
=> 
=< 
<> 
>< 
SNext (nve) 


SQuery (gvar) 


AVN * E+ 


Creates unique number 
from 3-character 
String. | 


Checks data type of a 
variable. 


Finds the position of a 
given character within 
a string. 


Obtains the next 
element in an array. 


Truncates the 
fractional part of a 
decimal number. 


Calculates length of a 
String. 


marg._))Allows floating 
point calcula- 


tions. 


Obtains next step after 
nve. 


Finds next 
global node. 


(physical) 
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Table 4-1 (Cont.) 
Summary of Functions 


ee ee 


SRoot (nve) Finds square root. 


SView (nve) Returns the contents of 
core location. 


SAltercase (svl) Converts upper case 
ASCII to lower and vice 
versa. 


SExtract (svl,nve, {,nve>}) 


Extracts characters 
from specified 
positions in a String. 


S$Piece (svli,svl2,nve,; {,nve2}) | 7 
Extracts fields within 
a string. 


SStep (nve) Obtains contents of a 
step. 


SText (nve) Converts numbers to 


4.2 FUNCTION DESCRIPTIONS 


The following paragraphs define the purpose and use of MUMPS 
functions. The symbols used to define the syntax of each function are 
the same as those used in Chapter 3. Definitions of these symbols can 
be found under the Document Conventions section of this manual. 


Function descriptions are presented in alphabetic order for ease of 
reference. 
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S$ALTERCASE 


4.2.1 SALTERCASE Function 


Type: String 
Syntax: SAltercase (svl) 


Description: 


The SA function is used to convert alphabetic characters from lower 
case to upper case and vice-versa. When converting lower case to 
upper case, lower case character codes in the range 97 through 122 
(141, - 1723) are mapped to their upper case equivalents in the 
range 65 through 90 (101, - 1323). When converting upper case to 
lower case, upper case character codes are converted to equivalent 
lower case codes; mapping is the reverse of that specified above. 
Conversion is performed on a character-by-character basis. The 
programmer may not nest $A functions in a command string. 


Example: 


Assuming: NAM(1) = "uncle", NAM(2)="hYpOCraTes",NAM(3)="thomas" 


1.10 F T=lsi1:3 S NAMCID=SACNAMCID) T NAMCI) 


The above program converts the strings contained in three 
variables to their alternate case. Thus: 


UNCLE 
HyPocRAtES 
THOMAS 
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4.2.2 SCREATE Function 


Type: Numeric 
Syntax: SCreate (svl) 


Description: 


This function creates a unique positive 21-bit MUMPS number, in the 
range 0.00-20,971.51, from the first three characters of a specified 
String. Each character is converted from 8 to 7 bits to permit 
storage within the 21l-bits. Conversion is performed using the 
following formula: 


N=((C (1) *2(14) +(C(2) *2(7) ) +C(3)) /100 


Where: N=resulting number 
C, = decimal character code for lst character 
C» = decimal character code for 2nd character 
C3 = decimal character code for 3rd character 


The relationship of the characters to the resulting number is~ shown 
below: 


BIT 31 . 22 21 1443 7 6 r) 


ar tst CHAR (Cy) 2nd CHAR (Co) 3rd CHAR (C3) 


11-1447 


If fewer than three characters are available, the characters are left 
justified within the resulting numbers. The programmer can use the 
SText function (Section 4.2.15) to convert the created number back to 
ASCII. 


Example: 


$C can be used to create subscripts from strings allowing data to be 
stored in subscript form. The following command line might be used to 
create subscripts for a program to maintain a telephone book. Assume 
three levels of subscripting based on the first nine characters of a 
last name (S, contains the first three characters, S>2 the second 
group of three and S3 the last three characters and NUM=telephone 
number). 


>SET ,TELC$C(S(1)),$C08(2)),$C0803))) =NUM 
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4.2.3 SDEFINE Function 


Type: 


syntax: 


Numeric 


SDefine ( 


Description: 


The $DEFINE function checks the data type of either local or global 
variables. The argument to the function is the name of the variable 
to be checked. There are eight possible data type values returned: 


Examples: 


i 


Data Type Definition 


undefined variable 

Single numeric datum 

string datum 

double numeric datum 

pointer to structure at Lower level or 

local array name 

5 pointer or local array name and single 

| numeric valued datum 

6 pointer or local array name and string 
valued datum 

7 pointer or local array name and double 
numeric datum 

8 4-word floating point numeric (resultant 

from SM) 


m WN RH © 


If local variable B contains a numeric quantity less than 
327.68, its data type is l. 

>T $D(B(2)) 

! 


> 


If global variable + ABC(X,Y) contains the string "JOHN DOE" 
and has no lower level associated with it, its data type is 


>T C 
2 
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4.2.4 SEXTRACT Function 


Type: String 
Syntax: SExtract (svl,nve, {inves | ) 
Description: 


The SEXTRACT function extracts all the characters from the specified 
string variable or literal (svl) that are between character positions 


specified by nve, and nve2g inclusive. If nve; is greater than 
nveo, SEXTRACT returns a ‘null string'. If nvez is equal to 
nve; or if nveo is omitted, SEXTRACT returns the character 
specified by nvei. Values of nve; which are less than 1 are 


interpreted as l. If the length of the string is such that SE runs 
out of characters before satisfying nve,, then the function returns 
all characters between nve, character and the end of the string. 
Only the integer part of nve; and nve»y are considered. 


NOTE 


1. If the string argument (svl) is a 
global variable, no other arguments 
may be global variables. 


2. Nesting SE functions in a command 
String is illegal. 


Example: 


Assume that the string variable NAM="JOHN DOE" is to be changed 
to the form: last-name, comma, first-name. The following 
Statements will do it, using the concatenation operator (@) and 
the SFIND function (Section 4.2.5): 


>& NAM=" JOHN DOE” 

> 

>1.56 S LST=$ECNAM,SFCNAM,” “,1),$LCNAM)) 
>1.58 S FIR=SECNAM,1 ,SFCNAM,” ™,9)-2) 


>1.40 S NAM=LST@","@FIR 
>D 1 


>T aan 
DOE, JOHN 
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4.2.5 SFIND Function 


Type: Numeric 
Syntax: SFind (svli,svl>. {rave t ) 


Description: 


The SFIND function returnS a number representing the 


position of the character following sve. within svl,. 
for sSvlo> Within svl, begins at the first character 
optional nve is given, in which case the search beqdins 
character in svl,. If nve is negative or Svl, is not 
SFIND returns zero (0). | | 


NOTE 


Only one of the arguments can be a 
global variable. 


Example: 


>S STR="ABCDEFGHIL” 


>T_SFCSTR,"A™, 1) 
2 returns 2 


>T_$FCSTR,"A™) returns 2 
2 
i) 


>T_SFCSTR,"GHI") 


16 returns 10 
>T $F CSTR," HI JU") returns OQ. String does 
8 string, HIJ. 


returns 0, since "A" does 
after third character in the string 


The 


character 


search 


unless the 
at the nveth > 


found 


not 


not 


, then 


occur 


contain 
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4.2.6 SHIGH Function 


Type: Numeric 


gvar 
Syntax: eHigh ( lvar (subscript) 


Description: 


The SHIGH function is used to locate the next numerically greater 
Subscripted variable in either a local or a global array. SHIGH 
compares the value of the subscript in the argument to the values of 
all other subscripted variables in the array (at the same subScripting 
level). When the variable having the next higher subscript is found, 
(SHIGH returns the value of that subscript. If there is no higher 
Subscript,) SHIGH returns-0.01. A negative subscript value is used in 
the argument to determine the existence of a variable with a subscript 
of zero. If SH detects a subscript that is higher by an increment of 
0.01, it terminates the search and returns that value since 0.01 is 
the smallest allowable increment between two subscripts. For this 
reason, the use of contiguous subscript values having increments of 
0.01 can provide improvements in program execution speed when many 
SHIGH's must be performed. | 


Examples: 


1. Given local array: A(1),A(2.5),A(3.68) 


SH(A(1)) returns 2.5 
SH(A(2.5) ) returns 3.68 
SH(A(1.5) ) returns 2.5 
SH(A(3.68) ) returns -0.01] 


2. Given global array:+B(1),tB(1,1),+B(1,2),+B(1,1,1),tB(1,1,3), 
TEC) fl 4340) 


SH(+B(1)) | returns -0.01 
SH(tB(1,1)) returns 2 
SH(*B(1,2) ) returns -0.01 
SH(*B(1,1,1)) returns 3 
SH(*B (151,52) ) returns 3 
SH(*B(1,1,3)) returns -0.01 
SECT B Clty 341) } returns 0 
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4.2.7 SINTEGER Function 


Type: Numeric 
Syntax: SInteger (nve) 


Description: 


The SINTEGER function returns the integer portion of the specified 
numeric valued expression (nve). The fractional part of the nve is 
truncated. 


Example: 


This program checks for odd and even numbers by using SI _ to 
discard any remainder resulting from division by 2. If the 
numbers are equal after multiplying the result by the divisor, 
the number iS even. SI is also used to discard any fractions 
that are input. | 


>1.19 READ “TYPE A NUMBER -",A,! © A=$ICA) 
>1.20 IF $I1CA/2)*2=A T “EVEN”,! G 1.1} 


>1,30 TYPE “ODD",! G Il 


>D I 


ee ad 


TYPE & NUMBER - 


| 


ODD 

TYPE A NUMBER -56 

EVEN 

TYPE A NUMBER -241 

ODD 

TYPE A NUMBER -2346.02 
EVEN ar 


TYPE A NUMBER - 


FUNCTIONS 


$LENGTH 


4.2.8 SLENGTH Function 


Type: Numeric 
Syntax: SLength (svl) 
Description: 


The SLENGTH function returns the number (quantity) of characters 
contained in the specified string variable or literal (svl). The 
length of a string may range from 0 to 132 characters. 

Example: 


The following steps use SL to format an output line. 


1.32 READ !,"NAME=",NAM,” ADDRESS=",ADR, ! Gl 
1.34 TYPE “NAME: ",NAM,?7(SLCNAM)+22),"ADDRESS: ",ADR,! G1! 

>D_! 

NAME=ELSIE PFLUGG ADDRESS=34 GUELPH COURT 

NAME: ELSIE PFLUGG ADDRESS: 34 GUELPH COURT RT 


FUNCTIONS 


$M 


4.2.9 SM Function 


Type: Numeric 
+ + 
Syntax: = = 
* * 
SM(marg, / |margg ...| / marg ) 
> > . 
< < 
oO >= 
=> => 
<= <= 
=< = 
<> <> 
>< >< 


Description: 


The $M function allows standard arithmetic and relational arithmetic 
Operations to be performed on numbers outside the normal range of 
MUMPS numbers. SM expressions produce four-word, double precision 
floating-point results in the absolute value range .14x107°° 
<n<1.7X10°® with $an accuracy’ = of 17 significant digits. $M 
expressions produce either a floating-point or fixed-point result 
depending on the last operation performed. When the last operator is 
an arithmetic operator, the expression result is a floating-point 
number which is stored as a data type 8 datum (see S$D_ function 
description). When the last operator is a relational arithmetic 
operator, the result is a fixed-point (MUMPS) number, either -0.01 for 
True relations or 0.00 for False relations. 


When a floating-point result is converted to a_ string, the 
floating-point data is in the form: 


O.nn ...nD mm for positive numbers greater than 1 

O.nn ...nD -mm for positive numbers greater than 0 and less than 
1 

-Q.nn ...nD mm for negative numbers less than -l 

-O.nn ...nD -mm for negative numbers less than O and greater than 
-| . 


Expression operands (marg) must be within the subset of standard 
Operands shown below: | 


1. A constant 
2. A simple variable that contains a character string 


representation of either a MUMPS number or ae valid 
floating-point number. Except for the floating-point output 
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FUNCTIONS 
formats shown above, mixed alphanumeric strings (e.g., 
"]123ABC") are interpreted as zero value. 


3. A simple local variable or a global variable that contains 
the results of a previous SM operation. 


4. A subexpression. 


Illegal use of SM expressions may produce MODER or SMERR_ error 
messages. 


Examples: 


The following are examples of legal SM expression operands: 


STR where: STR ="-6.123D 5" 12. 
STR = "5" 19.7346 
STR =".15672" 478655.1 
STR ="67651.98" -14.07 
M where: M =0.12D-14 X + 4.43% (3.2742) 
M =-0.373468D04 where: X 0.12D-03 


Z "0.17365421D-07" 
Wherever a String interpretation of a numeric quantity is indicated, a 
floating-point datum is permitted. However, conversion of a 
floating-point datum to a fixed-point number is not allowed. Thus, 
although floating-point numbers can be used with string operators, a 
floating-point number cannot be used with arithmetic operators outside 
of a SM function, and care should be taken when using the equality 
operator with a floating-point numeric. 


The following examples illustrate string conversion of a 
floating-point number. 


>S_yA = $M(2*4)@, oT 1A,!,$D(A) 
0.8D,_,01 
2 


>S.,A = $M(2*4),B = A@"***") oT OB 
0.8D,_,01*** 


>S.jA = SM (2"4) = Al O."D" De {01 
-0.01 


The following examples demonstrate the use of SM with the TYPE 
command: 


>T SMCA)," **s SMC A¥4)," "*, $MCAB)>» °° "es SM CC)» °° **, €¢MCD) 
6-2D @1 @-8D 6! @-8D @}1 @-D 86 @-1D @2 
> 


>S_ E=$M(CA+(Be2)-5) TE >S G=SM(A-B*10000) T $MC(G*1000000) 
Oe 5D BI -@.2D 11 

> > 

>S GeSMCA-B/18000) T G >S_ Jz#2 T SMC) 

“6 2D- 63 

= MODER>@ @ 
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>S tHC1l,1)=SM(D#A+(B/2)/8; T PHC 1s 1) 
®. 36666666666666667D 0) 
> 


>T $MC(2)," **s $M 1 23456-1234)" *, $MC-25D 2) 
@-2D @1 @e1234561234D 6 @-25D 62 


BoA’, ! I *] T Jo" IT'S FA 


>S H=$M(B>A),I=$M(A¢52B) I H TH," 
-8-80i BA 
@ 1T°S FALSE 


> 


FUNCTIONS 


$NEXT 


4.2.10 SNEXT Function 


Type: Numeric 
Syntax: SNext (nve) 


Description: 

The SNEXT function returns the Step number of the first Step following 
the Step specified by nve. If there are no Steps following the value 
of nve, SNEXT returns zero (0). 


Example: 


If a program has the following steps: 


07 

1.32 

4.9] 
10.13 
then: 

SN (1.01) returns 1.32 
SN(1.32) returns 4.91 
SN(2.35) returns 4.91 
SN(4.91) returns 10.13 
SN (10.13) returns 0 


FUNCTIONS 


$PIECE 


4.2.11 SPIECE Function 


Type: String 
Syntax: SPiece (Svl,,Svl2. nve, {raver | ). 


Description: 


The SPIECE function examines the string specified by svl,, which is 
assumed to be divided into "fields" delimited by the first character 
of Svl2. SPIECE returns the string value contained in the fields 
Specified by the two arguments nve; and nve2, inclusive. 


If nve, is not specified: 


1. a null string is returned where nve;<0 


th 


2. the (nve, ) field is returned (without delimiters) where 


nve,>0. 
If nveo is specified: 
1. and nve; <0,nve; is set to l. 


2. anull string is returned where nve2<nve,. 


th 


3. the (nve,~) field is returned (without delimiters) where 


nveo = nve,. 


If S$PIECE runs out of fields before reaching nveo, it returns any 
characters between the delimiter (svl1l_.) and the end of the 
string. 


NOTE 


dee LE Sve, is a global variable, no 
other argument can be global 
variables. 


2. Nesting $P functions is illegal. 


Examples: 


Given: STR="34,6.09,JOHN DOE,BOSTON,JUN,22" 
DE L= ; " 
X=7 


Y=3 


SPIECE (STR,DEL,3) 
SP (STR,",",¥,X-Y) 
SPIECE (STR,"O",4) 
SP (STR,","8) 


SP (STR, " ",1) 


FUNCTIONS 


returns 'JOHN DOE' 

returns 'JOHN DOE, BOSTON 

returns ‘ST! | 
returns a null string since there is no 
8th field in sve(l) 

returns '34,6.09,JOHN' 


FUNCTIONS 


$QUERY 


4.2.12 SQUERY Function 


Type: Numeric 


Syntax: $Q (gvar) 
Description: 


This function allows global nodes at a given level to be sequentially 
processed in the physical order in which they appear. This is 
particularly useful when used with the naked global syntax. $Q first 
searches for the node indicated by gvar, and then returns the next 
physical subscript within that same block (or continuation block). $Q 
returns -0.01 when the subscript indicated by gvar is the last 
physical subscript at that level. If a nonexistent global node is 
indicated by gvar, $Q returns the value -0.02. If the last subscript 
indicated in gvar is negative, $Q returns the first (physical) 
Subscript at that level. 


Example: 


This example lists all the nodes of global tM at the 5th level in the 
physical order in which they appear: — 


>t,1 S$ Az-1 
02 S A=$QC4M(9,9,8,4,A)) I Ame 


>! 


oo | ak ak 


Note the use of the SL System Variable. 


>D 1.1 

12O*x*1 GZ 

1** TOM 

Ox*x 5452 

5x2 43 

GK ALFRED 

T** 789 

Rx* 7TUU 

1 @**WH 34 
3*x*x2ALFRED NEMBHH 
4** 435 KLIPCH ST 
9*x* JACK O°C 


> 


FUNCTIONS 


$ROOT 


4.2.13 SROOT Function 


Type: ‘Numeric 
Syntax: SRoot (nve) 


Description: 


The $ROOT function returns the square root (numeric value) of nve, to 
two decimal places of accuracy. The nve must be positive, otherwise a 
MINUS error is generated. 


Examples: 


Ts. >T $R(64) 
8 


> 


Be >T_ $R(2) 
1.41 


> 


FUNCTIONS 


SSTEP 


4.2.14 SSTEP Function 


Type: String 
Syntax: SStep (nve) 


Description: 


The $STEP function returns a string value which is the contents of the 
Step specified by nve. The string begins with the first character 
following the space after the Step number, and ends with the last 
character in the line. This function is useful when programs need to 


store certain data in non-executable Parts. Nesting $S functions is 
illegal. 


Example: 


The program segment below shows what might be part of a command 
evaluator. The program asks the user for an option number. If a 
2? is typed, the program types a 'menu' of the options available. 
The menu is stored under its own part number and each entry is 


contained within a step as a literal. This part is never 
executed. The FOR loop indexes on the step numbers containing 
the 'menu', and SStep extracts each literal, in turn, to be 
output. | 

>1.12 READ “OPTION? ",X QUIT:x="" 

>1,.20 IF X€"?" F [T=1@.12.1218.5 TYPE !,$S (C1) 


>12.1@ | ALPHA SEARCH 

>18.28 2 NUMERIC SEARCH 

>18,.58 3 PAYRO 

>10.4@ 4 FILE MERGE 

>12.58 5 OUTPUT TRANSACTION FILE 


>D_ 


OPTION? a 


1 ALPHA SEARCH 

2 NUMERIC SEARCH 

3 PAYROLL NO. SORT 

4 FILE MERGE 

5 OUTPUT TRANSACTION FILE 


> 


FUNCTIONS 


STEXT 


4.2.15 STEXT Function 


Type: String 
Syntax: SText (nve) 


Description: 


The STEXT function translates the numeric argument nve to return up to 
four ASCII characters, one per byte. Each byte is masked to 7 bits, 
Starting with the high-order byte. If it is null, it is simply 
ignored. 


STEXT is primarily for use by system programmers who are familiar with 
the internal data formats of the MUMPS system. STEXT is often used in 
conjunction with the VIEW command to convert the contents of a 
location known to contain ASCII data. Nesting $T functions is 
illegal. 


Examples: 


1. This command line types out the characters contained in _ the 
lst word of the UCI Table.’ 


>1.2 A 63 T STCSVC$V($V(44)4+8))/180) 


2. Step 1.2 A reconverts a subscript, created in Step 1.1 by SC, 
back to a string. 


>1,.1@ S B=$C("TST") 
>!1,.2@ T $T(B/16384) @$T((B/128) &2 .55) GST (B&Z 055) 


>D_ 1 


SA 


— 


> 


1. Described in the MUMPS Programmer's Guide. 


FUNCTIONS 


$VIEW 


4.2.16 SVIEW Function 


Type: | Numeric 
Syntax: SView (nve) 


Description: 


The SVIEW function returns an integer that is the decimal value of the 
contents of the memory location specified by the nve. The function 
operates on a word (aS opposed to byte) address basis. Therefore, 
even if the nve is an odd number, it is interpreted internally as an 
even number by subtracting one. (See also the VIEW command, Section 
3.3.25.) Only the integer portion of the nve iS accepted, decimal 
fractions are ignored. | 


The use of SVIEW is restricted to users who are logged in under’ the 
system's User Class Identifier code (UCI number 1) and to programs 
that reside under the control of UCI number 1 (either System Utility 
programs or Library Programs). 


NOTE 


1. Protection features do not apply 
when referencing locations in the 
PDP-ll's External Page (locations 
51344, through 65535,, ie 


2. The S$VIEW function allows access’ to 
28K words of memory. For systems 
with more than 28K words of memory, 
any references for address locations 
(nve) 40960 - 57342 will be 
interpreted as address locations 0 - 
16382 beginning at the base of the 
current partition 


Examples: 
1. SV (0) Examine memory location 0 as a word 


2. $V (16.62) Examine memory location 164, as a word (note 
| decimal fraction is ignored) 


3. SV (3) Examine memory location 2 as a word 
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GLOSSARY OF TERMS 


Array An array, which can consist of either 
local or global variables, is a group of 
SubsScripted variables that have a common 
identifier. 


Binary Operator A binary operator iS an operator that 
requires two operands (expression 
elements). 


Boolean Valued Expression A Boolean Valued Expression (bve) 1S an 
| expression, which, when evaluated, 
produces either a True (-0.01) or False 

(0) result. 


Command A command is the principal algorithmic 
component of the MUMPS Language. MUMPS 
commands consist of a set of keywords 
that ‘characterize actions. (e.g., GOTO, 
SET, HALT, RUN, etc.). 


Concatenation Concatenation is the process of linking 
together two or more string data 
elements to form a Single string. 


Concatenation iS a string expression 
operation that is designated by the 
commercial "at" Sign (@). 


Constant A constant iS a quantity within the 
range of legal MUMPS numbers 
(+21474836.47) explicitly stated in an 
argument to a command or as an operand 
in an expression. 


Data Base Data base is that body of disk-stored 
information reSiding in global arrays. 

Direct Mode Direct Mode is that mode of system 
operation which enables the programmer 
to: 


1. enter commands and/or functions for 
immediate execution 


2. create or modify steps of a user's 
program 


Directory 


Double Numeric Quantity 


Expression 


Expression Element 


Floating Point Numeric 


Function 


Global 


Global Variable 


GLOSSARY OF TERMS 


A directory is a disk resident table 
which can contain the names and disk 
Starting addresses of either programs or 


global files. Each User Class 
Identifier in a MUMPS-1l system is 
associated with two directories; a 
program directory, and a global 
directory. 


This term refers to MUMPS numbers’ whose 
absolute values lie in the range +327.68 
through 21474836.47 which are stored by 
the operating system in two consecutive 
words. (See also Single Numeric 
Quantity.) 


An expression is any legal combination 
of operands (elements) and operators. 
Legal expression elements include: 
literals, constants, variables, 
subexpressions, and function references. 
An expression may consist of a single 
element an element/operator combination 
Or a series of element/operator 
combinations. 


An expression element is the operand 
component of a MUMPS expression. An 
expression element may be a constant, a 
Simple variable, a literal, a local 
Subscripted variable, a global variable, 
a function reference, Or a 
Subexpression. 


A 4-word floating point number in the 
range +0.14*10% to #1.7*10%  . The 
MUMPS SM function allows floating point 
numbers to be used with the operators + 
- * / <> =. A Floating Point number may 
be stored only as a local variable which 
is not the name of an associated array 
(i.e., pointer variables are excluded) 
or as a global variable. 


A function is a MUMPS expression 
component that invokes an algorithm, the 
result of which is an expression element 
(operand). Each MUMPS function is 
assigned a unique mnemonic, the first 
character of which is the dollar sign 
(S$) symbol. 


A global is a tree-structured data file 
stored in the common data base on the 


disk. Globals comprise an external 
system of symbolically referenced 
arrays. 


A global variable is a subscripted 
variable that forms an element (or node) 
of a global array. 


Identifier 


IF Switch 


Indirect Mode 


Indirect Reference 


Job 


Library Program 


Literal 


GLOSSARY OF TERMS 


An identifier is a name consisting of 
one to three alphanumeric characters. 
The first character must be either = an 
alphabetic character or the percent (%) 
symbol. Identifiers are used as names 
for variables, programs, library (or 
system) programs, and globals. The 
percent symbol is’ reserved for naming 
Library Programs and Globals, though any 
local variable can use percent as the 
first character of its name. 


The IF Switch is a logical Switch that 
resides in the Program Vector area in 
each user's partition. This switch is 
set to the logical result of the last 
executed IF statement, either True 
(-0.01) or False (0). Note that an IF 
without arguments or an ELSE only tests 
the logical value of the IF Switch and 
does not change it. 


Indirect Mode is that mode of system 
operation in which the steps of a stored 
program are executed. In this mode of 
operation, commands cannot be entered 
from the terminal and programs cannot be 
created or modified. 


An indirect reference is a feature of 
the language that permits a string 
variable to represent a command's 
argument Or argument list. In 
operation, the string value of the 
variable is taken as the argument or 
argument list. The indirection symbol, 
back arrow (+) or underscore (_.), must 
precede the variable reference. 


A job is any user activity which 
requires the use of a partition. For 
example, logging in or STARTing a 
program are Jobs... 


This term refers to those programs’ that 
are listed in the Program Directory of 
the System UCI (UCI #1) and have a 
percent symbol (3) as the first 
character of their names. Programs 
residing in the system in this way can 
be run by any user regardless of UCI. 


A literal is an element of the language 
that permits the explicit representation | 
of character strings in expressions”7 and 
in command and function arguments by 
delimiting them with quotation marks 
(""). Literals may not contain: 


quotation marks CTRL O Line Feed 
Carriage RETURN CTRL C Form Feed 
ALTMODE CTRL U Vertical Tab 
RUBOUT (DEL) NUL 


Local Variable 


Naked Reference 


Node 


Numbers 


Numeric Valued Expression 


Operator 


Part Number 


Partition 


GLOSSARY OF TERMS 


A local variable is a variable that 
resides in the partition of the program 
that created it (as opposed to a_ global 
variable). 


The naked reference is a feature that 
provides an abbreviated method for 
accesSing global variables to reduce 
disk access time. This permits 
subsequent references to a global to be 
made simply by specifying an up-arrow 
(+) followed by one or more subScripts. 
The variable name iS assumed from the 
last global reference in which a name 
was explicitly stated. The first 
subscript in the naked reference 
replaces last subscript in the previous 
reference (either naked or complete). 
Using the naked reference reduces disk 
access time since the search for’ the 
specified node begins at the 
subscripting level attained by the last 
global reference rather than at the 
global directory level. 


A node is ae global array element 
addressed by a subscript. 


Numbers in MUMPS are Signed fixed-point 
quantities in the range +21474836.47. 
Decimal fractions greater than two 
places are truncated to two places. 


A numeric valued expression (nve) is” an 
expression which, when evaluated, 
produces a numeric result. 


An operator 1S a component of a MUMPS 
expression that invokes an algorithm to 
perform either arithmetic, string, or 
Boolean manipulations. (See binary 
operator and unary operator). 


A part number is the integer portion of 
a step number and is used to refer 
collectively to all steps having a 
common integer base. 


A partition is the memory area within 
which a job resides. A partition is 
allocated to a job either at terminal 
log-in time or upon execution of the 


START command. A partition contains 
both program and local variable storage 
areas as well as program state 


information necessary for timesharing 
operation. 


GLOSSARY OF TERMS 


Pattern Verification Pattern verification is a feature of the 
language which permits evaluation of 
text strings for the occurrence of 
desired combinations of alphabetic, 
numeric, and punctuation characters. 
Pattern verification is specified by the 
i da operator followed by Pattern 
Specification Codes (psc). 


Principal I/O Device This term refers to the keyboard 
terminal that initiated the job. This 
is the device to which control returns 
when an error message iS to be output or 
when an ASSIGNesO command is issued. 


Program Name A program name is an identifier that is 
associated with a particular program. 
System Library program nameS must-~ use 
the percent symbol (3) as the first 
character. 


Programmer Access Code The Programmer Access Code (PAC) is a 
three-character code, created at System 
Generation time, that allows the 


terminal usSer to enter Direct Mode. 


Queue A gueue is an ordered list in which the 
first item to be entered is the first 
item to be removed (first-in-first-out 
sequence). 


Run Queue The Run Queue iS a System Queue which 
contains the number of the job currently 
executing in its time slice. This queue 
is effectively a one entry queue. 


secondary Storage This term refers to all I/O devices 
which are not used to contain the global 
data base (non-disk), (i.e., paper tape, 
magtape, or DECtape). 


Single Numeric Quantity This term refers to MUMPS numbers in the 
range +327.67 which are stored by the 
operating system in one 16-bit word. 
(See also Double Numeric Quantity). 


Sparse Array A sparse array refers to the method of 
Storage allocation used for local and 
global arrays in which space is 
allocated only as variables are 
explicitly defined (unlike other 
languages which require dimension or 
size statements for preallocation of 
storage). 


Step Number A step number iS a number used _ to 
identify each line of a MUMPS program. 
A step number must be in the range 0.01 
- 327.67, excluding all numbers in this 
range that are integers. 


String A string iS a contiguous combination of 


any of the ASCII characters. (132 
characters maximum) 
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GLOSSARY OF TERMS 


String Concatenation See Concatenation. 


String Valued Expression A string valued expression (sve) iS an 
expression which produces ae string 
result upon evaluation. 


Subexpression A subexpression iS an expression element 
: | that consists of any legitimate 
expression enclosed in parentheses. 


Subscripts A subscript is a numeric valued 
expression or expression element which 
is appended to a local or global 
variable name to uniguely identify 
specific elements of an array. 
Subscripts are enclosed in parentheses. 
Multiple subscripts must be separated by 
commas. 


Subscripted Variable A subscripted variable iS a variable to 
which a subscript is affixed (see 
Subscript and variable). Both global 
and local variables are forms of 
Subscripted variables. 


System Program A System Program iS a program either 
Supplied by DEC or created by the MUMPS 
user which is used to assist the MUMPS 
system owner in the operational 
maintenance of the system. System 
Programs normally reside under the 
protection of the System UCI (UCI #1). 


System Queues This term refers to the set of queues 
used by the MUMPS Operating System to 
control the allocation of system 
resources (see Run Queue and Wait 
Queue). 


System UCI The System User Class Identifier (UCI) 
code is that UCI code assigned to the 
first entry in the system's UCI table. 
The Program and Global Directories 
associated with the System UCI are used 
to contain both System and Library 
programs and globals. 


System Variable A System Variable is a variable that is 
permanently defined within the operating 
system. These variables provide system 
and control information to all programs. 
The first character of a System Variable 
is always a dollar sign (S$). System 
Variables are maintained and modified by 
the operating system and/or system 
manager only. 


Time Slice This term refers to the period of time 
allocated by the operating system to 
process a particular partition's 
program. This term is synonymous with 
"timesharing interval'. © 


GLOSSARY OF TERMS 


Unary Operator 


User Class Identifier (UCI) 


Variable 


Wait Queues 


A unary operator iS an operator that 
requires a single operand (expression 
element). 


A UCI is a three-character code used at 
terminal log-in time to permit access to 
the group of programs and global _ files 
with which it is associated. When used 
with the Programmer Access Code, the UCI 
allows these programs to be modified and 
new programs ta be created. 


A variable is the symbolic 
representation of a logical storage 
location. Specific types include local, 
global, Simple and subscripted 
variables. Variables are symbolically 
referenced by means of identifiers. 


The Wait Queues are a group of System 
Queues which contain the numbers of the 
jobs awaiting service by the operating 
system. 


” 


APPENDIX B 


MUMPS CHARACTER SET 


The following table shows, with the corresponding octal and decimal 
equivalents, the 128-character set of 7-bit ASCII code used by MUMPS 
for data, command, and control purposes. In addition, the order of 
the character set as shown establishes the MUMPS collating sequence 
used by the system's Expression Evaluator when establishing string 
relationships. 


For command and control purposes, MUMPS uses the 64-character graphic 
Subset. The system also uses the control codes shown in brackets 
({ ]). These codes should not be used as input data. The NUL, code 
000, is used internally as a logical end-of-message and cannot be 
used. Characters shown in braces ({ eS) are part of the 1963 ASCII 
Character Set and may appear in the character set of some terminals, 


All characters may be used for data input and output except for these 
mentioned above. The system does not perform any character 
conversion. It is the programmer's responsibility to perform all 
upper/lower-case letter conversions or mappings which are required for 
the particular application. 


CHARACTER SET 
Octal Code Decimal Code Character Octal Code Decimal Code Character 

000 | 000 NUL [025 021 NAK (CTRL U)*] 
001 001 SOH (Backspace)f 026 022 SYN 
002 002 STX (Forward space) 027 023 ETB 
003 003 ETX (CTRL C)* (Write EOF)f | 030 024 CAN 
004 004 EOT (Write block )+ 031 025 EM 
005 005 ENQ (Rewind)+ 032 026 SUB 
006 006 ACK (Read block)+ [033 027 ESC (ALT MODE)* ] 
007 007 BELL 034 028 FS 
010 008 BS* (Read label)+ 035 029 GS 
011 009 HT 036 030 RS 
012 010 LF 037 031 US 
013 011 VT 040 032 _ Space 
014 012 FF 041 033 ! 
015 013 CR 042 034 7 
016 014 SO 043 035 # 

[ 017 015 SI(CTRL 0)* | 044 036 § 
020 016 DLE 045 037 % 
021 017 DCI. 046 038 & 
022 018 DC2 047 039 ; 
023 019 DC3 050 040 ( 
024 020 DC4 051 041 ) 


*Asterisk denotes the control function for MUMPS terminals, if different from specified or other use. 
{Dagger denotes the control function for magtape devices. 


MUMPS CHARACTER SET 


CHARACTER SET (Cont) 
Octal Code Decimal Code Character Octal Code Decimal Code Character 
052 042 * 125 085 U 
053 043 + 126 086 V 
054 044 : 127 087 W 
055 045 ~~ 130 088 4 
056 046 ; 131 089 Y 
057 047 / 132 090 Z: 
060 048 0 133 091 { 
061 049 a 134 092 \ 
062 050 2 135 093 | 
063 051 3 136 094 A <t 
064 052 4 137 095 a (<— 
065 053 5 140 096 \ 
066 054 6 141 097 a 
067 055 7 142 098 b 
- 070 056 8 143 099 Cc 
071 057 9 144 : 100 d 
072 058 : 145 101 e 
073 059 : 146 102 f 
074 060 < 147 103 g 
075 . 061 = 150 104 h 
076. 062 > 151 105 i 
077 — 063 ? 152 106 j 
100 064 @ 153 107 k 
101 ~ 065 A 154 108 ] 
102 066 B 155 109 m 
103 067 C 156 | 110 n 
104 068 D 157 11] fe) 
105 . 069 _—E 160 112 p 
106 070 F 161 113 q 
107 071 G 162 114 r 
110 072 H 163 115 S 
11] 073 I 164 116 t 
112 074 J 165 117 u 
113 075 K 166 118 Vv 
114 076 L 167 119 Ww 
115 077 M 170 120 x 
116 078 N 171 121 y 
117 079 O st ee 122 z 
120 080 P 173 123 { 
121 081 Q 174 124 ! 
122 082 R 175 125 } { (ALT MODE)* 
123 083 S 176 126 ~ J(ALT MODE)* 
124 084 T 177 127 DEL (RUBOUT)} 


*A sterisk denotes the control function for MUMPS terminals, if different from specified or other use. 
} Dagger denotes the control function for magtape devices. 


APPENDIX C 


EXPLANATION OF MUMPS MESSAGES 


When execution of a MUMPS program is terminated by either an error, a 
CTRL C, or by pressing the BREAK key, the program executive outputs a 
Short message to indicate the reason for termination. This message is 
followed by the number of the Step being executed and the program name 
unless the error occurred while in Direct Mode. The error message 
format is: 


?message>spnz_yonam 
MUMPS messages are categorized as follows: 


1. MUMPS Programming Error Messages ~- result from errors 
associated with programming problems (either incorrect 
language syntax or semantic miSunderstandinads). 


2. Voluntary Program Termination Message - there is only one 
message of this type. 


3. Debugging Aid Message - indicates that a BREAK command has 
been encountered in the program. 


4. Operating System Error Messages - result from various 
troubles which are detected by the operating system and which 
are beyond the control of the MUMPS application programmer. 


MUMPS errors are considered terminal unless the user's program Sets 
the SE System Variable for application program control of error 
processing. The programmer may Set SE to a Step or Part number 
(SawSE=spn) to which control will go if an error occurs (except 
GARBO - GARE4 errors which are reported only on the console terminal, 
and do not terminate a running job). When SE is set to an spon and an 
error occurs, the system transfers control to the spn and resets SE to 
an index in the range 0 through -0.37 which indicates the type of 
error encountered (e.g., 0 = INRPT, -0.01 = MXNUM - see below). The 
number of the Step that contains the error is entered in the SW System 
Variable. The system also cancels all currently active DO, FOR, and 
CALL commands. It is the user's responsibility to reset SE to an spn 
if he wishes to control further error processing; otherwise, error 
processing reverts to system control. 


If an error occurs and SE is not set by the programmer, the action 
taken by the system depends on the mode in which the user signed on at 
log-in. If the programming access code (PAC) was used, control is 
returned to Direct Mode after the error message is output. Otherwise, 
the job is aborted after typing the error and 'EXIT' messages and the 
terminal is automatically logged-out. 


Each of the messages is explained on the pages which follow: 


EXPLANATION OF MUMPS MESSAGES 


C.1 MUMPS PROGRAMMING ERROR MESSAGES 


Message SE Index Meaning 
CMMND -0,15 Indicates illegal use of a command: 
1. Command is undefined in the 


language; 


2. An argument has been omitted where 
required. 


DIVER -0.19 Indicates an attempt to perform division 
by zero. 
DKSER -0.04 If not a system software error (Section 


C.4) this user software error indicates 
an attempt to: 


1. use VIEW command to access ae block 
number larger than size of the 
referenced disk, or a nonexistent 
disk; or 


2. use the disk (e.g., creating global 
variables, issuing the FILE, LOAD, 
etc., commands) under a UCI that has 
no associated directories. 


FRACT -0.08 Indicates that a fractional number was 
encountered when the process being 
executed was expecting a integer number. 
Also involved when a Step number has no 
fractional part. 


FUNCT -0.07 Indicates that the function is undefined 
in the language. 


LBOV | -0.14 Indicates an attempt to input or output 
a line greater than 132 characters. 


SMERR -0,36 Indicates that an error occurred in 95M 
processing. 


1. exponent overflow 
2. exponent underflow 


3. division by 0 


4. illegal trap instruction (system 
error) 
MINIM -0.03 Indicates that a number has more than 


two digits following the decimal point. 


MINUS -0.12 Indicates that a negative or zero number 
was encountered when a positive number 
was expected. For example, MUMPS causes 
a MINUS error if the user references a 
Subscripted variable with a negative 
Subscript: Only positive subscripts are 
allowed, except when using the SHIGH 
function (Section 4.2.6). | 


C-2 


Message 


MODER 


MXNUM 


MXSTR 


NAKED 


NODEV 


NOPGM 


NOTSY 


NXMEM 


PGMOV 


EXPLANATION OF MUMPS MESSAGES 


SE Index 


—O.23 


-0.01 


=0502 


=O29 


-0.13 


-0.28 


-0.34 


=0505 


-0.24 


Meaning 


1. An nve was encountered where an svl 
waS expected or vice versa. 


2. Argument to STEXT is not numeric. 
3. Argument to SVIEW is not numeric. 


Indicates that the value of a number has 
exceeded the integer bounds set by the 
MUMPS system. The maximum value for a 
number is +21474836.47. 


Indicates that the string has exceeded 
maximum length allowed (132 characters). 


Indicates that the present user 
attempted to reference a global variable 
uSing "naked" syntax: 


1. prior to any full syntax reference; 
or 


2. after another user KILLed the global 
variable. 


Indicates an attempt to ASSIGN a 
nonexistent device or the use of an 
lllegal device number. 


Reference is made to a program name that 
does not exist in the program directory 
for this UCI and is not in the directory 
of Library (%) Programs. 


Indicates that the referenced device or 
function iS not in the system (it may 
not have been linked at system 
generation). 


Non-Existent Memory was referenced in 
VIEW command or SVIEW function. 


Indicates that there is insufficient 
space available in the partition. 
Caused by: 


1. too many program steps in the 
program being created via the 
terminal or in the program being 
loaded; (LOAD, CALL and OVERLAY 
commands) 


2. too many local variables; 


3. expression or subscript nesting too 
deep. 


Message 


PROT 


SBSCR 
OPNER 
STKOV 
STKUN 
SYMOV 


SYNTX 


UNDEF 


C.2 VOLUNTARY 
Message 


INRPT 


EXPLANATiUN OF MUMPS MESSAGES 


SE Index 


-0.06 


-0.09 


Ue 17 


-0.10 


= O31 1 


=O... 16 


aO027 


Oo 2 


Meaning 


Indicates that an attempt waS made _ to 
use either the VIEW Command or the SVIEW 
Function from a non-Library (%) Program 
or when not logged in under the System 
UCI. Also indicates that the MODIFY 
command issued from Indirect Mode 
specified an spn smaller than the 
current spn. 


Indicates illegal subscript usage: 


- subscript out of range; 
- negative subscript. 


Indicates that an illegal or nonexistent 
Step or Part number was used. 


Indicates that the available stack space 
is used up. Generally indicates nesting 
is too deep in DO or CALL statements. 


Indicates execution of the Overlay 
command from Direct Mode (stack 
underflow). 


Symbol Table Overflow occurred on an 
attempt to create or change a local 
variable. 


Indicates that the current Step being 
executed has an error in syntax. Syntax 


errors include illeaqal punctuation, 
illegal use of operators, illegal use of 
parentheses, as well as errors 


encountered in editing a Step. Syntax 


errors comprise a great majority of 


errors made in the MUMPS' system and 
usually the user will be able to 
determine the exact cause of the error 
by merely looking at the Step concerned. 


Indicates a reference to an undefined 
local or global variable. 


PROGRAM TERMINATION 


SE Index 


0 


Meaning 


Signifies interruption OF program 
execution caused by typing CTRL C or 
pressing the BREAK key. 


EXPLANATION OF MUMPS MESSAGES 


C.3 DEBUGGING AID MESSAGE 


Message SE Index Meaning 
2n BREAK None Indicates that program control has 


reached a BREAK command at Step on. 
BREAK commands are used to interrupt 
execution of the program for debugging 
Purposes. The GO command may be typed 
to resume operation. 


C.4 MUMPS OPERATING SYSTEM ERROR MESSAGES 


Message SE Index Meaning 


GARBO 
GARB1 
GARB2 
GARB3 


GARB4 


DBDGD 


DKDER 


DKFUL 


DKHER 


DKSER 


None 
None 
None 
None 


None 


=0.31 


-0.33 


=0%.26 


-0.20 


-0.04 


Disk 
Disk 
Disk 


Disk 


error 


error 


error 


error 


while 
while 
while 


while 


reading 
writing 
reading 


writing 


a 


a 


a 


a 


data block. 
data block. 
bit map. 


bit map. 


Disk error, an attempt to deallocate a 
bit map or data block not yet allocated. 


NOTE 


The above errors are disk errors 
detected by the system's Garbage 
Collector routine. The message 
is output to the console 
-terminal. GARB1 ~~ and GARB3 
result in suspension of all disk 
I/O until system restart. 
Notify system manager. 


Indicates a data base degradation. The 
system attempted to read a block that 
was not actually allocated. Notify 
system manager. 


Indicates that a disk I/O error occurred 
on an attempt to write a global data 
buffer. The error is not given until 
the write is actually attempted. 


Indicates that there is no more room on 
the disk for global or program storage. 
Caused by SET and FILE commands. Notify 
system manager. 


Indicates disk hardware error. Notify 
system manager. 


In addition to conditions listed under 
Section C.l, this may indicate that disk 
block pointers in the global data base 
reference nonexistent or invalid disk 
blocks. Notify system manager. 


C=5 


Message 


DSKDG 


DTERR 


LPERR 


MTERR 


PARER 


PLDER 


SWAP 


EXPLANATION OF MUMPS MESSAGES 


SE Index 


-0.18 


-0.30 


-0.38 


-O.37 


None 


“06-59%... 


-0.32 


Meaning 


Indicates disk degradation. Attempt was 
made to allocate bit map for data 
storage. The system corrects the bit 
map subsequent to this error. Notify 
system manager. | 


Indicates DECtape hardware or operator 
error. Common causes are: 


l. not set to ON LINE 
2. not set to WRITE ENABLE 
3. unit number not selected 


Indicates a line printer hardware error. 
Common causes are: 


1. device off line 
2. out of paper 
3. yoke open 


4. power off 


Indicates magtape hardware or operator 
error as determined by the current 
contents of the SA System Variable. The 
system generates this error only if the 
user SET the SE System Variable. 


A parity error occurred on an 11/70 when 
referencing an address in the partition. 
The job is HALTed, and that partition 
cannot be reused. 


The system cannot retrieve the program 
being LOADed, CALLed, or STARTed. The 
FILE command did not complete writing 
the program. The user must re-FILE the 
back-up copy of the program. 


Indicates 


l. that the previous Swap-out 
overflowed the user partition stack. 
The error is not reported until the 
next Swap-in. 


2. imminent system stack overflow. May 
be caused by faulty programming 
techniques, for example: 


1.10 F I=1:1:1000 D 2 
2.10 Dl 


Message 


SYSDG 


SYSER 


EXPLANATION OF MUMPS MESSAGES 


SE Index 


-0.25 


-0.22 


Meaning 


Indicates that the table in main memory 
which represents the bit maps on a 
physical disk unit (Disk Storage 
Allocation Table) does not correspond to 
the block allocation specified by the 
disk's bit maps. The Disk Block Tally 
Utility Program allows recovery from 
this error. Notify system manager. 


System stack underflow on swapout. 
Notify system manager. 


APPENDIX D 


SYMBOL USAGE 


The following special symbols are used by MUMPS in addition to the 
logical operators described in Chapter 2. 


Symbol 


# 


Definition 


Number sign is used as a format control character to 
initiate a Page Feed or a FORM FEED on an output 
device. 


Exclamation point is used as a format control character 
to initiate a Carriage RETURN/LINE FEED sequence on an 
output device. 


Question mark is multiply defined: 


l. aS an output format control character for 
terminals, line printer and paper-tape punch, it is 
followed by an nve to indicate the number of spaces 
to tabulate in from the absolute left margin(e.g., 
?5=5 spaces from the left margin); 


2. aS an expression operator, it is followed by a 
Pattern Specification Code (psc). 


3. it is the first character printed when a BREAK 
command or error interrupts a program's execution. 


Comma is used as the term separator in an argument 
list. 


Space is multiply defined: 


1. A command followed immediately by two Spaces 
indicates the command has no arguments; 


2. One space separates a command from its arguments, 
or the last argument of a preceding command from 
the next command on the line. 


Colon is multiply defined: 


1. a delimiter for field separation in the argument of 
FOR, MODIFY, and ASSIGN commands. 


2. used to indicate the presence of an optional 
expression appended to a command or the argument of 
a command (where allowed). 


Symbol 


=e 


4 or 


SYMBOL USAGE 
Definition 


3. used to indicate the presence of an optional bve 
appended to a command (;bve may not be appended to 
FOR, ELSE or IF commands). If the bve is true, the 
command is executed. If the bve is false, control 
is passed to the next command on the line or the 
next line (whichever is applicable). The "next 
command on the line" is identified by skipping to 
the second space following the bve. If a bve is 
appended to a command no argument of that command 
may contain a space (i.e., a string literal 
enclosed in quotes). 


Semicolon is used as a delimiter to indicate that the 
remainder of a line iS a comment. 


Right caret is the prompting character used by MUMPS-1l 
when operating in Direct Mode to signal to the user 
that the system is ready to accept a command; that is, 
commands and functions may be entered for immediate 
execution, or program steps may be entered for program 
execution. 

Dollar sign is multiply utilized. 

1. precedes the first character of a System Variable. 
2. precedes the first character of a function name. 


Percent sign iS used as the first character of a 
library program or library global name. 


Quotation Marks are used to delimit literals. 


Back arrow or underscore iS used to _ specify the 
indirection operation for command argument replacement. 


Up-arrow or up caret precedes a global variable 
reference. : | 


APPENDIX E 


CONVERSION TABLES 


2” IN DECIMAL 


x 2" x a x 2° 
0.001 1.00069 33874 62581 0.01 1.00695 55500 56719 0.1 1.07177 34625 36 
0.002 1.00138 72557 11335 0.02 1.01395 94797 90029 0.2 1.14869 83549 97 
0.003 1.00208 16050 79633 0.03 1.02101 21257 07193 0.3 1.23114 44133 44 
C.004 1.00277 64359 01078 0.04 1.02811 38266 56067 0.4 1.31950 79107 72 
0.005 1.00347 17485 09503 0.05 1.03526 49238 41377 0.5 1.41421 35623 73 
0.006 1.00416 75432 38973 0.06 1.04246 57608 41121 0.6 1.51571 65665 10 
0.007 1.00486 38204 23785 0.07 1.04971 66836 23067 0.7 1.62450 47927 12 
0.008 1.00556 05803 98468 0.08 1.05701 80405 61380 0.8 1.74110 11265 92 
0.009 1.00625 78234 97782 0.09 1.06437 01824 53360 0.9 1.86606 59830 73 
+n 
10°" IN OCTAL 
10° n 10° 10° n 10° 
1 0 1.000 000 000 000 000 000 00 112 402 762 000 10 0.000 000 000 006 
12 1 0.063 146 314 631 463 146 31 1 351 035 564 000 11 0.000 000 000 000 
144 2 0.005 075 341 217 270 243 66 16 432 451 210 000 12 0.000 000 000 000 
750 3 0.000 406 111 564 570 651 77 221 411 634 520 000 13 0.000 000 000 000 
23 420 4 0.000 032 155 613 530 704 15 2 657 142 036 440 000 14 0.000 000 000 000 
303 240 5 0.000 002 476 132 610 706 64 34 327 724 461 500 000 15 0.000 000 000 000 
641 100 6 0.000 000 206 157 364 055 37 434 157 115 760 200 000 16 0.000 000 000 000 
113 200 7 0.000 000 015 327 745 152 75 5 432 127 413 542 400 000 17 0.000 000 000 000 
360 400 8 0.000 000 001 257 143 561 06 67 405 553 164 731 000 000 18 0.000 000 000 000 
545 000 9 0.000 000 000 104 560 276 41 
n log,, 2, n log, 10 IN DECIMAL 
n n logyo 2 n log2 10 n n logio 2 n log, 10 
l 0.30102 99957 3.32192 80949 6 1.80617 99740 19.93156 85693 
2 0.60205 99913 6.64385 61898 7 2.10720 99696 23.25349 66642 
3 0.90308 99870 9.96578 42847 8 2.40823 99653 26.57542 47591 
4 1.20411 99827 13.28771 23795 9 2.70926 99610 29.89735 28540 
5 1.50514 99783 16.60964 04744 10 3.01029 99566 33.21928 09489 
Addition Multiplication 
Binary Scale 
Oth O08 “0 : 6S 0: sO 
Cet Le Os 1 Os Le or} -O-8 
1+1=10 Peis 
Octal Scale 
0} 01 02 03 04 O05 06 O07 
x = 3.11037 552421, e = 2.55760 5213053 i 0.44742 147707. 
="! = 0.24276 301556, e-! = 0.27426 530661: Iny = — 0.43127 233602, 
\/x = 1.61337 611067, Ve = 1.51411 230704, log2y = — 0.62573 030645, 
In = 1.11206 404435, logioe = 0.33626 754251¢ v¥25 1.32404 746320. 
log2 + = 1.51544 163223, logre = 1.34252 166245. ine = 0.54271 027760, 
V10 = 3.12305 407267, log2 10 = 3.24464 7411368 In 10 = 2.23273 067355. 


E-1 


293 
035 
916 
894 
095 
398 
47) 
248 
615 


676 
537 
043 
003 
000 


000 
000 
000 
000 


337 
657 
136 
411 
264 


022 
001 
000 
000 


aN rH 


ee) 


16 

33 

67 
134 
268 
536 
073 
147 
294 
589 
179 
359 
719 
438 
877 
755 
ld 
023 
046 
093 
186 
372 
744 
488 
976 
953 
906 
813 
627 
254 
509 
018 
037 
075 
151 
303 
606 
213 
427 
854 
709 
419 
838 
676 
352 
705 
411 
822 
645 


CONVERSION TABLES 


POWERS OF TWO 


n —n 

2 n 2 

kK “OO 

> “T. 05 

4 2. 0.25 

8 3 0.125 

16 4 0.062 5 
32 5 0.031 25 
64 6 0.015 625 
128 7 0.007 8125 
256 8 0.003 906 25 
512 9 0.001 953 125 


5 

25 

625 

812 5 

406 25 

203 125 

601 562 5 
800 781 25 
900 390 625 


0000 
to 
0777 
(Octal!) 


Octal 


10000 - 
20000 - 
30000 - 
40000 - 
50000 - 
60000 - 
70000 - 


1000 
to 
1777 
(Octal) 


0000 
to 
0511 
(Decimal) 


Decimal 
4096 
8192 

12288 
16384 
20480 
24576 
28672 


| 0512 
to 
| 1023 


| (Decimal) 


0000 
0010 
0020 
0030 
0040 
0050 
0060 
0070 


0100 
0110 
0120 
0130 
0140 
0150 
0160 
0170 


0200 
0210 
0220 
0230 


0240 | 


0250 
0260 
0270 


0300 
0310 
0320 
0330 
0340 
0350 
0360 
0370 


1000 
1010 
1020 
1030 
1040 
1050 
1060 
1070 


1100 
1110 
1120 
1130 
1140 
1150 
1160 
1170 


1200 
1210 
1220 
1230 
1240 
11250 
1260 
1270 


1300 
1310 
1320 
1330 
1340 
1350 
1360 
1370 


CONVERSION TABLES 


OCTAL-DECIMAL CONVERSION 
OCTAL-DECIMAL 


0624 
0632 


0640 
0648 
0656 
0664 
0672 
0680 
0688 
0696 


0704 
0712 
0720 
0728 
0736 
0744 
0752 
0760 


INTEGER 


CONVERSION TABLE 


7 
0007 0258 0259 
0015 0266 0267 
0023 0274 0275 
0031 0282 0283 
0039 0290 0291 
0047 0298 0299 
0055 0306 0307 
0063 0314 0315 
0071 0322 0323 
0079 0330 0331 
0087 0338 0339 
0095 0346 0347 
0103 0354 0355 
111 0362 0363 
0119 0370 0371 
0127 0378 0379 
0135 0386 
0143 0394 
0151 0402 
0159 0410 
0167 0418 
0175 0426 
0183 0434 
0191 0442 


0450 
0458 
0466 
0474 
0482 


0773 
0781 
0789 
0797 
0805 
0813 
0821 
0829 


0837 
0845 
0853 
0861 
0869 
0877 
0885 
0893 


0901 
0909 
0917 
0925 
0933 
0941 
0949 
0957 


0965 
0973 
0981 
0989 
0997 
1005 
1013 
1021 


0774 
0782 
0790 
0798 
0806 
0814 
0822 
0830 


0838 
0846 
0854 
0852 
0870 
0878 
0886 
0894 


0902 
0910 
0918 
0926 
0934 
0942 
0950 
0958 


0966 
0974 
0982 
0990 
0998 
1006 
1014 
1022 


CONVERSION TABLES 


OCTAL-DECIMAL INTEGER CONVERSION TABLE (continued) 


200011024 1025 1026 1027 1028 1029 1030 1031 1286 1287 2000 1024 
2010/1032 1033 1034 1035 1036 1037 1038 1039 1294 1295 to to 
2020}1040 1041 1042 1043 1044 1045 1046 1047 1302 1303 2777 1535 
203011048 1049 1050 105) 1052 1053 1054 1055 1310 1311 (Octal) | (Decimal) 
2040;'1056 1057-1058 1059 1060 1061 1062 1063 1318 1319 
2050/1064 1065 1066 1067 1068 1069 1070 1071 1326 1327 
2060 |-1072 1073 1074 1075 1076 1077 1078 1079 1334 1335 
207011080 1081 1082 1083 1084 1085 1086 1087 1342 1343 Octal Decimal 
10000- 4096 

2100|1088 1089 1090 1091 1092 1093 1094 1095 1350 1351 20000- 8192 
2110) 1096 1097 1098 1099 1100 1101 1102 1103 1358 1359 30000 - 12288 
2120,1104 1105 1106 1107 1108 1109 1110 1111 1366 1367 40000 - 16384 
2130}1112 1213 1214 21215 21116 2117 1118 1219 1374 1375 50000 - 20480 
2140/1120 1121 1122 11:23 1124 1125 1126 1127 1382 1383 60000 - 24576 
215011128 1129 1130 1131 1132 1133 1134 1135 1390 1391 70000 - 28672 
2160/1136 1137 1138 1139 1140 1141 1142 1143 1398 1399 
2170/}1144 1145 1146 1147 1148 1149 1150 1151 1406 
2200/1152 1153 1154 1155 1156 1157 1158 1159 1414 
2210/1160 1161 1162 1163 1164 1165 1166 1167 1422 
2220/1168 1169 1170 1171 1172 1173 1174 1175 1430 
2239,1176 1177 1178 1179 1180 1181 1182 1183 1438 
2240/1184 1185 1186 1187 1188 1189 1190 1191 1446 
2250;1192 1193 1194 1195 1196 1197 1198 1199 1454 
2260} 1200 1201 1202 1203 1204 1205 1206 1207 1462 
2270 | 1208 1209 1210 1211 1212 1213 1214 1215 1470 

1220 1221 1222 1223 1478 

1228 1229 1230 1231 1486 

1236 1237 1238 1239 1494 

1244 1245 1246 1247 1502 

1252 1253 1254 1255 1510 

1260 1261 1262 1263 1518 


1268 1269 1270 1271). 1526 
1276 1277 1278 1279 1534 


3000 | 1536 
301011544 


3020, 1552 1553 1554 


3000 1536 
to to 
3777 2047 
(Octal) | (Decimal) 


1868 
1873 1874 1875 1876 1877 1878 1879 
1881 1882 1883 1884 1885 1886 1887 


3130/1624 1625 1626 

3140}1632 1633 1634 1889 1890 1891 1892 1893 1894 1895 
lke 1641 1642 1897 1898 1899 1900 1901 1902 1903 
3160/1648 1649 1650 1905 1906 1907 1908 1909 1910 1911 
ise ase 1657 1658 1913 1914 1915 1916 1917 1918 1919 
3200 !1664 1665 1666 1921 1922 1923 1924 1925 1926 1927 
3210 |1672 1673 1674 1929 1930 1931 1932 1933 1934 1935 


322011680 1681 1682 
3230 |1688 1689 1690 
324011696 1697 1698 


1937 1938 1939 1940 1941 1942 1943 
1945 1946 1947 1948 1949 1950 1951 
1953 1954 1945 1956 1957 1958 1959 
1961 1962 1963 1964 1965 1966 1967 
1969 1970 1971 1972 1973 1974 1975 


3270 | 1720 1721 1722 1977 1978 1979 1980 1981 1982 1983 


: | 
3300 '1728 1729 1730 
3310/1736 1737 1738 
332011744 1745 1746 
3330 11752 1753 1754 


1985 1986 1987 1988 1989 1990 1991 
1993 1994 1995 1996 1997 1998 1999 
2001 2002 2003 2004 2005 2006 2007 
2009 2010 2011 2012 2013 2014 2015 
2017 2018 2019 2020 2021 2022 2023 
2025 2026 2027 2028 2029 2030 203i 
2033 2034 2035 2036 2037 2038 2039 
2044 2045 


4000 
to 
4777 


CONVERSION TABLES 


OCTAL-DECIMAL INTEGER CONVERSION TABLE (continued) 


2048 
to 
2559 


(Octal) |(Decimal) 


Octal 

10000 - 
20000 - 
30000 - 
40000 - 
50000 - 
60000 - 
70000 - 


5777 
(Octal) 


Decimal 


4096 

8192 
12288 
16384 
20480 
24576 
28672 


3071 
(Decimal) 


2048 
2056 
| 2064 
207? 
4040! 20R0 
4050 
4060! 
4070| 2104 


4100! 7112 
2120 
2128 
2136 
2144 
2152 
2160 
2168 


2176 
2184 
e192 
; 2200 
2208 
2216 
2224 
A I 


2240 
2248 


| 2264 
4340) 2272 
4350! 2280 
4360! 2268 


4370! 2256 


5000: 2560 
5010 | 2568 
5020 | 2576 
5030! 2584 
5040: 2592 
' 2600 
2608 
2616 


2624 
2632 
‘2646 
2648 
5140 | 2656 
2664 
2672 
: 2680 


5200 | 2688 
2696 


5250: 2728 
5260 | 2736 


§300 | 2752 
531012760 
5320 | 2768 
5330 | 2776 
5340 | 2784 
5350 | 2792 
5360 | 2800 


2088 . 
2Q96 . 


2200 2 


5220 | 2704 < 


bee lao ea. 
ae hort ae 


527012744 % 


2801 


5370 | 2808 2809 


2563 
Zorl 
257 

2587 
2595 
2603 
2611 
2619 


2627 


2635 2 


2643 
2651 
2659 
2667 
2679 
2683 


2691 
2699 
©707 


2713.2 


Zteo 
2731 
2739 
2747 


27599 
2763 


2k 


2779 
Ziet 
2799 
2803 
2811 


—— ears _ . 
- nn ee 


4500 | 2368 
4510} 2376 
4520 2384 
4530 | 2392 
4540 | 2400 
4550! 2408 
4560 | 2416 
4570| 2424 


es 
4610 | 2440 
4620 | 2448 
4630 | 2456 
4640 2464 
4650 | 2472 
4660 | 2480 
4670 | 2488 
| 

4700 } 2496 
4710 | 2504 
4720} 2512 
4730| 2520 
47401 2528 
4750] 2536 
47601 2544 


t | ‘ 
4770 | 2552 


NN 
a id 
ce 
~) 
So 


0 


2305 
2313 
2321 
2329 
2337 
2345 
23055 
2361 


2369 
2377 
2385 
2393 
2401 
2409 
2417 
2425 


2433 
2441 
2449 
2457 
2465 
2473 
2481 
2489 


2497 
2505 
29kS 
2521 
2529 
2007 
2545 
2553 


] 


(2816 2817 


5400 | 
5410 


2824 2825 


5420 | 2832 
5430 | 2840 
5440 | 2848 
5450 | 2856 
5460 | 2864 
9470 | 2872 


5500 | 2880 
5510 | 2888 
5520 | 2896 
59530 | 2904 
59540 | 2912 
5550 | 2920 
9560 | 2928 
9970 | 2936 


5600 2944 
5610 42952 
5620 ; 2960 
5620 12968 
5640 | 2976 
5650 | 2984 
5660 | 2992 
5670 | 3000 


{ 
5 


2700 


2833 
2641 
2849 
2857 
2865 
2873 


2881 
2889 
2897 
2905 
2913 
2921 
2929 
2937 


2945 
2953 
2961 
2963 
2977 
2985 
2993 
3001 


3003 
3017 
3025 
3033 
3041 
3049 
3057 
3065 


2306 
2314 
2322 
2330 
2338 
2346 
2354 
2362 


2370 
2378 
2386 
2394 
2402 
2410 
2418 
2426 


2434 
2442 
2450 
2458 
2466 
2474 
2482 
2490 


2498 
2506 
2514 
2022 
2530 
2538 
2546 
2554 


2 


2818 
2826 
2834 
2842 
2850 
2858 
2866 
2874 


2882 
2890 
2898 
2906 
2914 
2922 
2930 
2938 


2946 
2954 
2962 
2970 
2978 
2986 
23994 
3002 


3010 
3018 
3026 
3034 
3042 
3050 
3058 
3066 


2819 
2827 
2835 
2843 
2851 
2859 
2867 
2875 


2883 
2891 
2899 % 
2907 
2915 
2923 
2931 
2939 


2947 
2955 
2963 
29071 
2e79 
2937 
2995 
3003 


3011 
3019 
3027 
3035 
3043 
3051 
3059 
3067 


CONVERSION TABLES 


OCTAL-DECIMAL INTEGER CONVERSION TABLE (continued) 


0 l 2 3 4 9 6 7 


6000 |3072 3073 3074 3075 3076 3077 3078 3079 6000 | 3072 
6010| 3080 3081 3082 3083 3084 3085 3086 3087 “ss ne 
60203088 3089 3090 3091 3092 3093 3094 3095 6777 | 3583 


6030/3096 3097 3098 3099 3100 3101 3102 3103 (Octal) | (Decimal) 


6040/3104 3105 3106 3107 3108 3109 3110 3111 
6050/3112 3813 3114 3115 3116 3117 3118 3119 


6060/3120 3121 3122 3123 3124 3125 3126 3127 Octal Decimal 


6070 | 3128 3129 3130 3131 3132 3133 3134 3135 10000- 4096 
6100 {3136 3137 3138 3139 3140 3141 3142 3143 Seeop 4eoee 
6110; 3144 3145 3146 3147 3148 3149 3150 3151 40000 - 16384 


50000 - 20480 
60000 - 24576 
70000 - 28672 


6120} 3152 3153 3154 3155 3156 3157 3158 3159 
6130; 3160 3161 3162 3163 3164 3165 3166 3167 
6140/3168 3169 3170 3171 3172 3173 3174 3175 
6150/3176 3177 3178 3179 3180 3181 3182 3183 
6160/3184 3185 3186 3187 3188 3189 3190 3191 
6170 | 3192 3193 3194 3195 3196 3197 3198 3199 


16200 | 3200 3201 3202 3203 3204 3205 3206 3207 
6210/3208 3209 3210 3211 3212 3213 3214 3215 
6220/3216 3217 3218 3219 3220 3221 3222 3223 
6230 | 3224 3225 3226 3227 3228 3229 3230 3231 
6240 (3232 3233 3234 3235 3236 3237 3238 3239 
6250 | 3240 3241 3242 3243 3244 3245 3246 3247 
6260 | 3248 3249 3250 3251 3252 3253 3254 3255 
6270 |3256 3257 3258 3259 3260 3261 3262 3263 


6300 (3264 3265 3266 3267 3268 3269 3270 3271 
6310 (3272 3273 3274 3275 3276 3277 3278 3279 
6320 | 3280 3281 3282 3283 3284 3285 3286 3287 
6330 | 3288 3289 3290 3291 3292 3293 3294 3295 
6340 | 3296 3297 3298 3299 3300 3301 3302 3303 
6350 | 3304 3305 3306 3307 3308 3309 3310 3311 
6360 } 3312 3313 3314 3315 3316 3317 3318 3319 
6370 [3320 3321 3322 3323 3324 3325 3326 3327 


7000 3584 
. to to 
is 7777 4095 


(Octal) | (Decimal) 


CONVERSION TABLES 


OCTAL-DECIMAL FRACTION CONVERSION TABLE 


Octal Decimal Octal Decimal Octal Decimal Octal Decimal 


. 000000 . 125000 . 200 . 250000 . 300 375000 
001953 . 126953 201 251953 301 376953 
. 003906 . 128906 . 202 . 253906 302 378906 
005859 . 130859 . 203 , 255859 303 . 380859 
007812 . 132812 . 204 257812 304 382812 
009765 134765 205 . 259765 305 384765 
011718 . 136718 . 206 , 261718 . 306 386718 
013671 . 138671 . 207 , 263671 307 388671 
015625 . 140625 210 . 265625 310 390625 
017578 . 142578 211 . 267578 ll 392578 
019531 . 144531 e2n2 . 269531 {312 394531 
. 021484 . 146484 213 271484 313 396484 
023437 . 148437 214 . 273437. 314 398437 
025390 . 150390 215 . 275390 315 400390 
027343 . 152343 216 . 277343 316 402343 
029296 . 154296 217 , 279296 317 404296 
031250 . 156250 . 220 , 281250 . 320 406250 
. 033203 . 158203 221 . 283203 321 408203 
035156 . 160156 , 222 . 285156 322 410156 
037109 . 162109 . 223 . 287109 323 412109 
. 039062 . 164062 224 . 289062 324 414062 
041015 . 166015 . 225 291015 325 416015 
042968 . 167968 . 226 . 292968 326 417968 
044921 169921 e027 , 294921 327 419921 
046875 171875 . 230 . 296875 . 330 421875 
. 048828 . 173828 Oni , 298828 331 . 423828 
050781 175781 232 300781 . 332 426781 
052734 . 137734 . 233 302734 . 333 427734 
. 054687 179687 . 234 . 304687 334 429687 
. 056640 . 181640 . 235 . 306640 335 431640 
. 058593 . 183593 . 236 . 308593 . 336 433593 
060546 . 185546 . 237 310546 337 435546 
062500 . 187500 . 240 312500 340 437500 
064453 189453 241 314453 341 439453 
066406 191406 242 316406 342 441406 
. 068359 193359 243 318359 343 443359 
070312 195312 244 , 320312 344 445312 
072265 14: . 197265 245 322265 345 447265 
074218 . 199218 . 246 324218 346 449218 
076171 201171 247 326171 347 6451171 
078125 203125 . 250 328125 350 453125 
. 080078 . 205078 251 . 330078 .351 -  —_, 455078 
. 082031 207031 252 332031 352 6457031 
083984 . 208984 253 . 333984 353 458984 
085937 210937 254 335937 354 . 460937 
. 087890 . 212890 255 . 337890 355 462890 
. 089843 214843 256 339843 356 464843 
091796 . 216796 257 341796 357 466796 
093750 , 218750 . 260 343750 . 360 468750 
095703 . 220703 261 345703 361 470703 
097656 . 222656 262 347656 362 472656 
099609 . 224609 263 349609 363 474609 
. 101562 226562 . 264 351562 364 476562 
103515 . 228515 265 353515 365 478515 
. 105468 . 230468 . 266 355468 , 366 480468 
107421 232421 . 267 357421 367 482421 
109375 . 234375 . 270 359375 370 484375 
111328 . 236328 271 361328 371 486328 
. 113281 . 238281 272 363281 372 488281 
115234 . 240234 273 , 365234 373 490234 
117187 242187 274 367187 374 492187 
119140 244140 275 369140 375 494140 
. 121093 . 246093 276 371093 376 496093 
. 123046 . 248046 277 373046 .377 498046 


CONVERSION TABLES 


-OCTAL-DECIMAL FRACTION CONVERSION TABLE (continued) 


Octal Decimal Octal Decimal Octal © Decimal | Octal Decimal 


- 000000 ..000000 .000100 . 000244 - 000200 . 000488 . 000300 . 000732 
000001 . 900003 . 000101 000247 000201 . 000492 . 000301 . 000736 
. 000002 . 900007 .000102 000251 . 000202 . 000495 . 000302 . 000740 
. 000003 . 000011 . 000103 .000255 . 000203 . 000499 . 000303 . 000743 
000004 . 000015 000104 . 000259 - 000204 . 000503 000304 . 000747 
. 000005 . 000019 . 000105 . 000263 ~ ,000205 . 000507 , 090305 000751 
- 000006 . 000022 . 000106 - 009267 . 000206 .000511 . 000306 . 000755 
. 000007 . 000026 . 000107 - 000270 . 000207 000514 . 000307 . 000759 
- 000010 . 000030 , 900110 . 000274 000210 . 000518 . 000310 . 000762 
000011 . 000034 000111 . 000278 000212 . 000522 . 000311 . 000766 
. 000012 . 000038 .000112 . 000282 000212 . 000526 000512 . 000770 
- 900013 . 000041 000113 . 000286 . 000213 . 000530 . 000313 . 000774 
. 000014 . 000045 000114 . 000289 . 000214 . 000534 — 000314 . 000778 
000015 . 000049 000115 . 000293 000215 . 000537 000315 . 000782 
. 000016. . 000053 000116 . 000297 . 000216 . 000541 . 000316 000785 
000017 . 000057 000117 000301 900217 . 000545 . 000317 . 000789 
- 000020 . 000061 . 000120 . 000305 . 000220 . 000549 . 000320 . 000793 
. 000021 . 000064 000121 . 000308 . 000221 . 000553 000321 . 000797 
. 000022 . 000068 000122 . 000312 000222 =. . 000556 . 000322 000801 
. 000023 . 000072 . 900123 . 000316 - 000223 . 000560 . 000323 . 000805 
. 000024 . 000076 000124 - 000320 . 000224 . 000564 . 000324 . 000808 
. 000025 . 000080 000125 . 000324 - 900225 . 000568 . 000325 . 000812 
. 000026 . 900083 000126 . 000328 . 000226 . 000572 . 000326 . 000816 
. 000027 . 000087 . 000127 . 000331 - 000227 . 000576 . 000327 . 000820 
. 000030 . 000091 .000130 . 000335 . 000230 . 000579 . 000330 . 000823 
. 000031 . 000095 000131 . 000339 - 000231 . 000583 . 000331 . 000827 
. 000032 . 000099 .000132 . 000343 . 000232 . 000587 . 000332 900831 
. 000033 . 000102 . 000133 . 000347 . 000233 . 000591 . 000333 . 000835 
. 000034 . 000106 . 000134 . 000350 . 000234 . 000595 . 000334 . 000839 
. 000035 . 000110 .000135 . 000354 000235 . 000598 . 000335 . 000843 
. 000036 000114 . 900136 . 000358 . 000236 . 000602 . 000336 . 000846 
. 000037 . 000118 .000137 . 000362 - 000237 . 000606 , 000337 . 000850 
. 000040 . 000122 . 006140 . 000366 . 000240 . 000610 - 000340 . 000854 
. 000041 . 000125 . 000141 . 000370 . 000241 . 000614 . 000341 . 000858 
. 000042 . 000129 . 000142 . 000373 . 000242 . 000617 . 000342 . 000862 
. 000043 . 900133 - 000143 .00037T . 000243 . 000621 . 000343 . 000865 
. 000044 . 000137 000144 - 000381 - 000244 . 000625 . 000344 . 000869 
000045 .900141 . 000145 . 900385 000245 . 000629 . 000345 . 000873 
. 000046 . 000144 . 000146 . 000389 - 000246 . 000633 . 00034t .C00877 
. 000047 . 000148 . 000147 . 000392 . 000247 . 000637 . 000347 .000881 
000050 . 000152 . 000150 000596 . 000250 . 000640 . 000350 . 000885 
. 000052 . 900156 000151 . 000400 . 000251 . 000644 . 000351 . 000888 
. 000052 . 000160 . 000152 . 000404 . 009252 . 000648 . 000352 . 000892 
. 000053 . 000164 000153 . 000408 900253 . 000652 . 000353 . 000896 
, 000054 . 000167 . 000154 .000411 000254 . 000656 . 000354 . 000900 
.000055 000171 000155 000415 . 000255 . 000659 . 000355 . 000904 
. 000056 . 000175 - 900156 . 000419 . 000256 . 000663 . 000356 . 000907 
. 000057 . 000179 . 000157 . 000423 . 000257 . 900667 . 000557 000911 
. 000060 . 000183 . 000160 . 000427 . 000260 , 000671 . 000360 000915 
000061 . 000186 000161 000431 - 000261 . 000675 . 000361 . 900919 
. 000062 - 900190 . 000162 - 000434 . 000262 . 000679 . 000362 000923 
. 000063 . 000194 . 900163 . 000438 . 000263 . 000682 . 000363 . 000926 
. 000064 . 000198 000164 . 000442 . 000264 . 000686 . 000364 . 000930 
. 000065 . 000202 000165 . 000446 . 000265 . 000690 . 000365 . 000934 
. 000066 . 000205 . 000166 . 000450 . 000266 . 000694 . 000366 . 000938 
000067 . 900209 - 900167 . 000453 . 000267 . 000698 . 000367 . 000942 
. 900070 . 000213 - 000170 . 000457 . 000270 . 000701 . 000370 . 000946 
. 000071 000217 000171 . 000461 . 000271 - 900705 . 000371 . 000949 
. 000072 . 000221 - 000172 000465 .000272 = .000709 . 900372 . 000953 
. 000073 . 900225 - 900173 . 000469 - 000273 . 000713 . 000373 . 000957 
. 000074 . 000228 - 000174 . 000473 . 000274 . 000717 000374 000961 
-, 000075 - 000232 000175 . 000476 . 000275 . 000720 . 000375 000965 
. 000076 . 000236 . 000176 . 000480 . 000276 . 000724 . 000376 . 000968 
000077 . 000240 000177 . 000484 . 000277 . 000728 . 000377 . 000972 


CONVERSION TABLES | 


OCTAL-DECIMAL FRACTION CONVERSION TABLE (continued) 


Octal Decimal Octal Decimal Octal Decimal Octal Decimal | 
000400  .000976 000500. 001220 /000600  .001464 .000700  , 001708 
000401  .000980 .000501  ,001224 .000601  .001468 .000701 001712 
000402  .000984 000502 =. 001228 .000602 001472 .000702 001716 
000403 =, 000988 000503 001232 .000603 001476 000703  , 001720 
000404 000991 000504 =, 001235 000604 001480 .000704 001724 
000405  , 000995 .000505 001239 .000605 001483 .000705 001728 
000406 000999 .000506 =, 001243 .000606  .001487 .000706 001731 
000407 , 001003 .000507 001247 .000607 -, 001491 .000707 +, 001735 
000410 , 001007 .000510 001251 000610  ,001495 .000710 001739 
000411 +, 00101C .000511  .001255 .000611 001499 .000711 ,001743 
000412 001014 .000512  ,001258 .000612 001502 ,000712 =, 001747 
000413 001018 .000513 001262 .000613 001506 .000713. . 001750 
000414 001022 .000514 001266 .000614 001510 000714, 001754 
000415 001026 .000515 001270 .000615 001514 000715 001758 
.000416 001029 .000516 001274 .000616 001518 .000716  .001762 
000417, 001033 .000517  .001277 000617 +, 001522 .000717  .001766 
000420  .001037 000520 .001281 000620 .001525 000720 001770 
000421 001041 .000521 001285 .000621 001529 000721 001773 
000422 001045 000522 =, 001289 000622 =. 001533 000722, 001777 
000423 =. 001049 000523 =. 001293 .000623 001537 000723. 001781 
000424 001052 000524 =, 001296 000624 .001541 .000724  ,001785 
000425 .001056 000525 001300 000625 001544 000725. , 001749 
000426 001060 000526  .001304 000626 =, 001548 000726  , 001792 
.000427 001064 000527 001308 000627 —-,.001552 000727 001796 
000430 001068 .000530 001312 000630 ,001556 000730 001600 
000431 001071 .000531 001316 000631  , 001560 000731  ,001804 
000432 001075 000532 001319 000632 .001564 000732 0013808 
000433 , 001079 000533 =. 001323 .000633 001567 000733 001811 
000434 001083 000534  .001327 000634 001571 000734 001815 
000435. , 001087 .000535 001331 .000635 001575 000735  .001819 
000436 001091 000536  . 001335 .000636 001579 000736  , 001823 
000437 001094 .000537  , 001338 000637 001583 000737 , 001827 
000440 001098 000540 001342 000640  .001586 000740 001831 
000441 ,001102 000541 001346 000641  .001590 000741 001834 
000442 001106 000542  ,001350 000642 001594 000742  .001838 
000443, 001110 000543 =, 001354 000643 =. 001598 000743 001842 
000444 =, 001113 000544 —, 001358 000644  .001602 000744 001846 
000445 =, 001117 000545 001361 000645 001605 000745, 001850 
.000446  , 001121 000546 001365 000646 .001609 000746 001853 
000447, 001125 000547 ~—-, 001369 000647 +, 001613 .000747 —-, 001857 
.000450  .001129 000550 , 001373 000650 001617 .000750 .001861 
000451 001132 .000551  , 001377 000651 .001621 .000751 001865 
000452 001136 .000552 001380 000652 001625 000752 001869 
000453 , 001140 000553 001384 000653 —-, 001628 .000753 , 001873 
.000454 001144 000554 001388 000654 001632 ,000754 001876 
000455 001148 .0005558  .001392 .000655  .001636 .000755 —. 001880 
000456  , 001152 .000556 =. 001396 .000656  .001640 000756 001884 
000457 001155 .000557 —, 001399 .000657 001644 .000757  .001888 
000460 001159 .000560 001403 .000660 001647 .000760  .001892 
000461  .001163 .000561  .001407 .000661 001651 .000761 001895 
000462 01167 .000562 .001411 .000662 .001655 000762 001899 
000463 =, 001172 .000563 001415 .000663  .001659 .000763 001903 
000464 =, 001174 000564 =, 001419 000664  .001663 000764  .001907 
000465  .001178 .000565 001422 .000665  .001667 .000765 ,001911 
.000466  ,001182 000566 001426 000666  , 001670 000766 .001914 
000467 001186 000567 —-. 001430 000667 001674 .000767 =, 001918 
000470 , 001190 .000570 001434 000670 , 001678 .000770 001922 
.000471  .001194 .000571 001438 .000671  , 001682 .000771 001926 
000472 , 001197 .000572  .001441 000672 001686 000772  , 001930 
000473 001201 .000573 001445 .000673  . 001689 000773  .001934 
000474 001203 .000574 001449 .000674  .001693 .000774 , 001937 
000475  , 001209 .000575 =. 001453 .000675  , 001697 ,000775 =, 001941 
000476 001213 000576 001457 .000676 .001701 .000776 001945 
.000477 , 001216 .000577. 001461 .000677 —. 001705 ,000777 , 001949 


Bag 


SAddress, 1-l1l 
SALTERCASE tunction, 4-4 
Ampersand (&) (Boolean AND), 


2-2, 2-14 

Apostrophe (') (Boolean NOT) 
2-2, 2-16 

Arithmetic operations, 2-6, 
4-12 


Arithmetic operators, 2-6 | 
relational operators, 2-8 
Arrays, 1-6 
sparse, 1-7 
ASCII code, B-l 
ASSIGN command, 3-5, 3-7 
At sign (@), 
as concatenation operator, 
as trailing operator, 2-16 


INDEX 


a 


2-8, 


2-14 


Automatic data mode conversion, 


2*5 


Boolean operators, 2-14 
AND, 2-2 
NOT, 2-2, 2-16 
Boolean truth table, 2-15 
Brackets, square ([]), 2-11 
BREAK command, 3-12 


Call command, 3-13 
Characters, control, 1-2 
Character set, 1l-l, B-l 
Command categories, 1-1 
Commands, 
format control, 3-3 
rules for syntax, 3-1 
symbology, 3-1 


Commas used aS separators, 1-5 


Comments, 3-2 
Concatenation operator (@), 
Constants, 1-5 
Continuation block, 1-9 
Control characters, 1-2 


2>14 


Conversion tables, mathematical, 


E-1 


Conversion to/from numeric string 


data, 2-5 
Conversion, upper/lower case 
alphabetic, 4-4 
SCREATE function, 4-5 


Data mode of results, 2-5 
Data modes, 1-3, 2-3 
automatic conversion, 2-5 


Data types of variables, 4-5 
Data values, 1-5 
SDate, l-ll 
Debugging, 3-12 

message, C-4 
Decimal fractions, 1-4 
SDEFINE function, 4-6 
Deletion of step or part, 3-27, 

3-53 

Deletion, 

via KILL command, 3-27 

via XKILL command, 3-53 
Device assignment, 3-7 
Device unasSsignment, 3-47 
Direct mode, 1-2 
DO command, 3-14 
Dollar sign ($) usage, 1-11 


Editing program, 3-27 

ELSE command, 3-15 

Equal sign (=) usage in relational 
operators, 2-8, 2-10 

ERASE command, 3-16 

SError, 1-11 

Error messages, programming, C-2 


Exclamation point (!) (Boolean OR), 


2-14 
Execution via DO command, 3-14 
Expressions, 2-l, 2-2 
evaluation of, 2-3 
SEXTRACT function, 4-7 


FILE command, 3-17 

SFIND function, 4-8 

FOR command, 3-18 

Format control commands, 3-3 
Function summary, 4-2 


Global nodes, 1-8, 1-9 
Global variables, 1-8 
Glossary, A-l 
GO command, 3-20 

GOTO command, 3-21 


HALT command, 3-22 
HANG command, 3-23 
SHIGH function, 4-9 
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Identifiers, 1-4 
IF command, 3-24 
Indirection syntax operator, 
Indirect mode, 1-2 | 
Input via READ command, 3-41 
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SINTEGER function, 4-10 
$IO device, 1-11 

SJOB status, 1-12 

KILL command, 3-27 
Language elements, 1-1 
SLENGTH function, 4-11 


Levels of subscripting, 1-9 
Literals, 1-5 
LOAD command, 3-26 


Loading via OVERLAY, 3-28 


Local variables, 1-7 
Simple, 1-7 
subscripted, 1-7 

SLocation, 1-11 

LOCK command, 3-31 

Looping, 3-18 


Mathematical conversion tables, 
E-1 

Messages, C-l 
SM function, 4-12 
Mnemonics for operators, 
Modes, 

of data, 1-3 

of programming, 1-2 
MODIFY command, 3-34 
Multiplication, 2-3 


2-6 


Naked syntax, 1-9 

examples, 1-10 
Names, 

of programs, 1-4 

of variables, 1-5 
Negative output, 1-4 
Nesting, 

of functions, 4-1 

of subexpressions, 2-3 
Nodes (array elements), 

processing of global, 
Numbers in MUMPS, 1-4 

for parts, 1-3 

for steps, 1-3 
Numeric data, 1-4 
Numeric data mode, 2-3 
Numeric operations, 2-1 


1-8, 1-9 
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Operating system error messages, 
C-4 
Operations, numeric, 2-1 
Operators, 
arithmetic, 2-6 
Boolean, 2-14 
indirection syntax, 
relational, 2-8 
relational string, 2-1ll, 2-12, 
2-13, 2-14 
relative equality, 2-10 
string concatenation (A), 
trailing, 2-5, 2-16 
Output commands, 
PRINT, 3-37 
TYPE, 3-46 
WRITE, 3-52 | 
OVERLAY command, 
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2-14 


37-39 


Parentheses usage in expressions, 
2-3 

Part numbers, 1-3 

Pattern verification, 

SPIECE function, 4-16 

Plus sign (+) used as trailing 
operator, 2-16 

Pointers in arrays, 1-10 

Precedence of expression evaluation, 
1-5 

PRINT command, 3-37 

Program loop, 3-24 

Programming modes, 1-2 
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$QUERY function, 4-18 

Question mark (?) (pattern verifi- 
cation), 2-12 | 

QUIT command, 3-39 

Quotation mark (") usage, 1-5 


READ command, 3-41 | 

Relational arithmetic operators, 
2-8 

Relational equality operators, 
2-10 

Relational string operators, 
2-11, 2-12, 2-13 

Restarting via GO command, 

Results, data mode of, 2-5 

SROOT function, 4-19 


2-10, 


3-20 


Search function (S$FIND), 4-8 
SET command, 3-43 | | 
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Simple variables, 1-7 Unary minus, 2-2 

Spaces in expressions, 2-3 UNASSIGN command, 3-47 

Square root function, 4-19 Underline used as indirection 
START command, 3-45 syntax operator, 3-2 
Starting via CALL command, 3-13 UNLOCK command, 3-48 

SSTEP function, 4-20 Up-arrow (* or +) character, 1-8 


Step numbers, 1-3 
Stopping via BREAK command, 3-12 
Storage allocation, 1-7 


»Storage, 1-12 Variables, 1-5 
Storing a program, 3-17 data types of, 4-6 
String concatenation operator (@), local, 1-7 

2-14 VIEW command, 3-49 
String data, 1-4 SVIEW function, 4-22 


String data mode, 2-3 
Strings, 1-4 
numeric, 1-4 
Structure of program, 1-2 SWhere, 1-12 
Subscripted variables, 1-7 WRITE command, 3-52 
Subscript levels, 1-6, 1-9 
Subscripts and arrays, 1-6 
Subscript values, 1-6, 4-9 
Symbolic names, 1-4, 1-5 SX coordinate, 1-12 
Symbols in relational string XKILL command, 3-53 
operators, 2-ll, 2-12 
Symbols used by MUMPS, D-l 
Symbols used in command formats, 
xXil SY coordinate, 1-12 
Syntax for commands, 3-1 
Syntax rules for functions, 4-1 
System variables, 1-5, 1-10 
table, 1-1l 


Termination messages, C-4 
Termination of MUMPS job, 3-22 
Termination via QUIT command, 


3-39 

STEXT function, 4-21 

STime, 1-12 

Trailing data mode operators, 
2-16 


Transfer of control, 3-21 
Truncation of decimal numbers, 1-3 
TYPE command, 3-46 
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Non-programmer interested in computer concepts and capabilities 


IN a a i es DCS 

Organization 

Street 

City. State UU ip Code 
— or 
Country 


If you require a written reply, please check here. {] 


(2 000 me GH GE TOR RE YP SE SOE PL ET OE ON fet DS ESC SN A SO SS EA A SY RY CNY OF oe Sa SE SE A ES NE ES SN SSN SE NN Fold Here 0 cs Ha SS DS aD Oa SE SD SY HT A NE HD GND SG SS SON SD SRN GL uy ON SS SN SA uA GSE et GOOG SND GN Se IAD GA OY GO GOS GON SE ME LO nh WORE SEN SOND SG 


(er ee en ee ee Do Not Tear - Fold Here and Staple ---------------------------------------------=- 


FIRST CLASS 
PERMIT NO. 33 


MAYNARD, MASS. | 


BUSINESS REPLY MAIL 
NO POSTAGE STAMP NECESSARY IF MAILED IN THE UNITED STATES 


Postage will be paid by: 


Software Communications 
P. O. Box F | 
Maynard, Massachusetts 01754 


fifo} tal 


digital equipment corporation 


Printed in U.S.A. 


